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Preface 


UNET  is  a  one-dimensional  unsteady  flow  model  that  can  simulate  flow  in  a  complex 
network  of  open  channels.  Because  of  its  capability  to  include  off-channel  storage  and 
overbank  storage  areas  UNET  may  be  thought  of  as  quasi-two-dimensional.  UNET 
was  developed  by  Dr.  Robert  L.  Barkau.  Under  agreement  with  Dr.  Barkau,  the 
Hydrologic  Engineering  Center  maintains,  distributes,  and  provides  training  for  UNET 
(see  memorandum  of  understanding  behind  cover  page).  This  manual  is  an  update  of 
the  May  1993  manual  (Version  2.1)  and  corresponds  to  version  3.0  of  the  HEC-UNET 
software.  Included  in  this  manual  and  associated  software  are  many  modifications  and 
enhancements  made  by  Dr.  Barkau  and  HEC  in  the  interim. 


XI 


Chapter  1 
Introduction 


Chapter  1  -  Introduction 


UNET  simulates  one-dimensional  unsteady  flow  through  a  full  network  of  open 
channels.  Figure  1-1  illustrates  one  basic  element  of  a  full  network  problem  which  is 
the  split  of  flow  into  two  or  more  channels.  For  subcritical  flow,  the  division  of  flow 
depends  on  the  stages  in  each  of  the  receiving  channels.  These  stages  are  a  function 
of  channel  geometry  and  downstream  backwater  effects. 


reaches  2  and  3.  The  volume  of  flow  along  each  reach 
depends  on  the  geometry  of  the  reaches  and  backwater  effects. 

A  second  basic  element  of  a  full  network  problem  is  the  combination  of  flow, 
termed  the  dendritic  problem.  This  is  considered  to  be  a  simpler  problem  than  the  flow 
split,  because  flow  in  each  tributary  is  dependent  only  on  the  stage  in  the  receiving 
stream.  The  full  network  is  the  most  general  problem.  It  includes  single  channels, 
dendritic  systems,  and  fully  looped  systems  (another  commonly  used  term  for  the  full 
network).  Figure  1-2  illustrates  a  dendritic  channel  system,  including  a  full  network. 
The  system  includes  flow  bifurcations,  a  crossing  canal,  a  four  node  junction,  and  a 
storage  area. 
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Another  facet  of  the  full  network  model  is  storage  areas;  lake-like  regions  that  can 
either  provide  water  to,  or  divert  water  from,  a  channel.  This  is  a  split  flow  problem, 
although  in  this  case,  the  storage  area  water  surface  elevation  will  control  the  volume  of 
water  diverted.  Storage  areas  can  be  the  upstream  or  downstream  boundaries  for  a 
river  reach.  In  addition,  the  river  can  overflow  laterally  into  the  storage  areas  over  a 
gated  spillway,  weir,  levee,  through  a  culvert,  or  a  pumped  diversion. 

In  addition  to  solving  the  one-dimensional  unsteady  flow  equations  in  a  network 
system,  UNET  provides  the  user  with  the  ability  to  apply  several  external  and  internal 
boundary  conditions,  including;  flow  and  stage  hydrographs,  gated  and  uncontrolled 
spillways,  bridges,  culverts,  and  levee  systems.  All  input,  output  and  calculations  are 
performed  in  U.S.  Foot-Pound  Units. 

To  facilitate  model  application,  cross  sections  are  input  in  a  modified  HEC-2 
forewater  format  (upstream  to  downstream).  A  large  number  of  river  systems  have 
been  modeled  using  HEC-2,  and  those  data  files  can  be  readily  adapted  to  UNET 
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format  (see  Appendix  E).  Boundary  conditions  for  UNET  can  be  input  from  any  existing 
HEC-DSS  (HEC,  1990b)  data  base.  For  most  problems,  particularly  those  with  large 
numbers  of  hydrographs  and  hydrograph  ordinates,  HEC-DSS  is  advantageous 
because  it  eliminates  the  tabular  input  of  hydrographs  and  creates  an  input  file  which 
can  be  easily  adapted  to  a  large  number  of  scenarios.  Hydrographs  and  profiles  which 
are  computed  by  UNET  are  output  to  HEC-DSS  for  graphical  display  and  for 
comparison  with  observed  data.  Guidance  for  numerical  modeling  of  river  hydraulics  is 
given  in  (USACE,  1993). 
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Chapter  2 


Equations  of  Motion  for 
the  Channel  and  Floodplain 


Figure  2-1  illustrates  the  interaction  between  the  channel  and  the  floodplain  that 
can  make  the  analysis  of  the  movement  of  a  flood  through  a  river  valley  a  two- 
dimensional  problem.  When  the  river  is  rising,  water  disperses  laterally  from  the 
channel,  inundating  the  floodplain  and  filling  storage  areas.  As  the  depth  increases,  the 
valley  begins  to  convey  water  downstream,  generally  along  a  shorter  path  than  that  of 
the  main  channel.  When  the  river  stage  is  falling,  the  water  moves  toward  the  channel 
from  the  overbank  storage,  supplementing  the  flow  in  the  main  channel. 

Because  the  primary  direction  of  flow  is  still  downstream,  this  two-dimensional 
problem  can  often  be  approximated  as  a  one-dimensional  system.  The  lateral  flow  can 
be  modeled  as  a  storage  area  which  exchanges  water  with  the  channel.  Flow  in  the 
overbank  can  be  approximated  as  flow  through  a  separate  channel. 


Figure  2-1  A  typical  reach  of  river 


This  problem  has  been  addressed  in  many  different  ways.  A  common  approach 
is  to  ignore  overbank  conveyance  entirely,  assuming  that  the  overbank  is  used  only  for 
storage.  This  assumption  may  be  suitable  for  large  streams  such  as  the  Mississippi 
River  where  the  channel  is  confined  by  levees  and  the  remaining  floodplain  is  either 
heavily  vegetated  or  an  off-line  storage  area.  Fread  (1976)  and  Smith  (1978) 
approached  this  problem  by  dividing  the  system  into  two  separate  channels  and  writing 
continuity  and  momentum  equations  for  each  channel.  To  simplify  the  problem  they 
assumed  a  horizontal  water  surface  at  each  cross  section  normal  to  the  direction  of 
flow;  that  the  exchange  of  momentum  between  the  channel  and  the  floodplain  was 
negligible;  and  that  the  flow  was  distributed  according  to  conveyance,  i.e.: 


Qc  = 


(2-1) 
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Where:  Q,, 
Q 


0 

Kc 

Kf 


=  flow  in  channel,  . 

=  total  flow, 

=  K,/(K,  +  K,), 

=  conveyance  in  the  channel,  and, 
=  conveyance  in  the  floodplain. 


With  these  assumptions,  the  one-dimensional  equations  of  motion  can  be 
combined  into  a  single  set: 


dA  ^  ^  e[  (1-(t))Q]  ^  Q 

dt  dx^  dXf 


^  ^  ^  5  ( (1  -^)WA, ) 

dt  dx^  ^  dXf 


9  K 


dz 

dx^ 


+  S, 


fc\ 


9  Af 


—+S. 

dXf 


ff 


=  0 


(2-2) 


(2-3) 


in  which  the  subscripts  c  and  f  refer  to  the  channel  and  floodplain,  respectively.  These 
equations  were  approximated  using  implicit  finite  differences,  and  the  full  nonlinear 
equations  solved  numerically  using  the  Newton-Raphson  iteration  technique.  The 
model  was  successful  and  produced  the  desired  effects  in  test  problems.  Numerical 
oscillations,  however,  can  occur  when  flow  at  one  node  bounding  a  finite  difference  cell 
is  within  banks  and  the  other  is  not. 

Expanding  on  the  earlier  work  of  Fread  and  Smith,  Barkau  (1982)  manipulated 
the  firiite  difference  equations  for  the  channel  and  floodplain  and  defined  a  new  set  of 
equations  that  were  computationally  more  convenient.  Using  a  velocity  distribution 
factor,  he  combined  the  convective  terms.  Further,  by  defining  an  equivalent  flow  path, 
he  replaced  the  friction  slope  terms  with  an  equivalent  force. 

The  equations  derived  by  Barkau  are  the  basis  for  UNET.  These  equations  are 

derived  in  Appendix  A.  The  numerical  solution  of  these  equations  is  described  in  the 
next  section. 


2.1  Implicit  Finite  Difference  Scheme 

The  most  successful  and  accepted  procedure  for  solving  the  unsteady  flow 
equations  is  a  four-point  implicit  scheme,  also  known  as  the  box  scheme  (Figure  2-2). 
Under  this  scheme,  space  derivatives  and  function  values  are  evaluated  at  an  interior 
point,  (n+6)  At.  Thus  values  at  (n+1)  At  enter  into  all  terms  in  the  equations.  For  a 
reach  of  river,  a  system  of  simultaneous  equations  results.  The  simultaneous  solution 
is  an  important  aspect  of  this  scheme  because  it  allows  information  from  the  entire 
reach  to  influence  the  solution  at  any  one  point.  Consequently,  the  time  step  can  be 
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Significantly  larger  than  with  explicit  numerical  schemes.  Von  Neumann  stability 
analyses  performed  by  Fread  (1974),  and  Liggett  and  Cunge  (1975),  show  the  implicit 
scheme  to  be  unconditionally  stable  (theoretically)  for  0.5  <6^  1.0]  conditionally  stable 
for  0.5,  and  unstable  for  6  <  0.5.  In  a  convergence  analysis  performed  by  the  same 
authors,  it  was  shown  that  numerical  damping  increased  as  the  ratio  /I /^x  decreased 
where  A  is  the  length  of  a  wave  in  the  hydraulic  system.  For  streamflow  routing 
problems  where  the  wavelengths  are  long  with  respect  to  spatial  distances, 
convergence  is  not  a  serious  problem.  In  practice,  other  factors  may  also  contribute  to 
the  non-stability  of  the  solution  scheme.  These  factors  include  dramatic  changes  in 
channel  cross-sectional  properties,  abrupt  changes  in  channel  slope,  characteristics  of 
the  flood  wave  itself,  and  complex  hydraulic  structures  such  as  levees,  bridges 
culverts,  weirs,  and  spillways.  In  fact,  these  other  factors  can  often  overwhelm  any 
stability  considerations  associated  with  0.  Because  of  these  factor.^,  anv  modfil 
application  should  be  accompanied  bv  a  sensitivity  study,  where  thfi  accuracy  and  thP 
st3bihtv_of  the  solution  is  tested  with  various  time  and  distance  intervals. 


(2-4) 

(2-5) 
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then: 

r  =  fj  *  ^ 

The  general  implicit  finite  difference  forms  are: 

1 .  Time  derivative 

^  ^  M  =  0-5 

dt  At  At 

2.  Space  derivative 

=  (^.1  -9  m.:  - 

dx  Ax  Ax 

3.  Function  value 

f-1  =  0.5  {fj  +  fj^,)  +  0.5  0  {Afj  +  Ay 


(2-6) 

(2-7) 

(2-8) 

(2-9) 


2.2  Continuity  Equation 

The  continuity  equation  conserves  the  mass  of  the  one-dimensional  system. 
From  Appendix  A: 


dA  ^  dS 

dt  dt 


dQ 

+  —  -  q  =  0 
dx 


(2-10) 


where:  x 
t 

Q 

A 

S 

% 


distance  along  the  channel, 

time, 

flow, 

cross-sectional  area, 
storage, 

lateral  inflow  per  unit  distance. 


The  above  equation  can  be  written  for  the  channel  and  the  floodplain: 


ao,  ^  ^ 

ax^  at 


(2-11) 


(2-12) 
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where  the  subscripts  c  and  /refer  to  the  channel  and  floodplain,  respectively,  p,  is  the 
lateral  inflow  per  unit  length  of  floodplain,  and  and  are  the  exchange  of  water 
between  the  channel  and  the  floodplain. 

Equations  2-1 1  and  2-12  are  now  approximated  using  implicit  finite  differences, 
applying  Equations  2-7  through  2-9: 


Ax,  At 


(2-13) 


AQf  A/A,  AS  - 

-  +  -  +  -  =  +  Q, 

Ax,  At  At  ^ 


(2-14) 


Now,  the  exchange  of  mass  is  equal  but  not  opposite  in  sign  such  that  Ax^q^  =  -q/AXf. 
Then,  adding  the  above  equations  together  and  rearranging  yields: 


AA,  AA 

AQ  +  — -  Ax^  + 


At 


— '  AXf  +  —  AXf  -  Q.  =  0 
At  '  At  ^  ' 


where  (Jj  is  the  average  lateral  inflow. 


(2-15) 


2.3  Momentum  Equation 

The  momentum  equation  states  that  the  change  in  momentum  is  equal  to  the 
external  forces  acting  on  the  system.  From  Appendix  A,  for  a  single  channel: 


dQ  ^  djVQ) 
dt  dx 


*  gA(^  +  S,)  =  0 

dx 


(2-16) 


where:  g  =  acceleration  of  gravity, 

Sf  =  friction  slope, 

V  =  velocity. 

The  above  equation  can  be  written  for  the  channel  and  for  the  floodplain: 


^  ^  diVcQg) 
dt  "  ax. 


(2-17) 
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dQf  ^  djVfQf) 
dt  dXf 


gA,  (|i  * 
dx, 


(2-18) 


where  and  M,  are  the  momentum  flux  per  unit  distance  exchanged  between  the 
channel  and  floodplain,  respectively.  Note  that  in  Equations  2-17  and  2-18  the  water 
surface  elevation  is  not  subscripted.  An  assumption  in  these  equations  is  that  the  water 
surface  IS  horizontal  at  any  cross  section  perpendicular  to  the  flow.  Therefore,  the 

water  surface  elevation  is  the  same  for  the  channel  and  the  floodplain  at  a  given  cross 
section.  ^ 


Using  Equations  2-7  through  2-9,  the  above  equations 
finite  differences: 


are  approximated  using 


Af  Ax, 


+ 


Az 

Ax, 


-'fc 


^  ^  A{V,Q,) 
At  AXf 


+  gA, 


Az 

AXf 


Note  that  Ax,M,  =  -Ax,Mf. 


Adding  and  rearranging  the  above  equations  yields: 


(2-19) 


(2-20) 


A(Q,Ax,+  Q,Ax.) 

+  giAa+Af)Az+ gA^Sf^Ax^+ gAfSf/^Xf=0  (2-21) 


The  final  two  terms  define  the  friction  force  from  the  banks  acting  on  the  fluid  An 
equivalent  force  can  be  defined  as: 


gA  Sf  Ax,  -  gA^SfJ^x^  +  gA,S,/^x,  (2-22) 

where:  zlx,  =  equivalent  flow  path, 

S,  =  Wctic^  slope  for  the  entire  cross  section, 

A  =  A,  +  A,. 

Now,  the  convective  terms  can  be  rewritten  by  defining  a  velocity  distribution  factor: 

^  ^  V^A,)  _  0^  +  V,Q,) 

V^A  01/  {2-2Sj 
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then: 


A(P1/Q)  =  A{V^Q^  +  A{V,Qf) 

The  final  form  of  the  momentum  equation  is: 


(2-24) 


At 


+  A(3\/Q)  +  gAAz  +  gASfAXg  =  0 


(2-25) 


A  more  familiar  form  is  obtained  by  dividing  through  by  Ax^, 


^  Q,ax,)  ^  ^  ^ 

A.,  "^'A.,  •  ' 


At  Ax. 


Ax 


Ax„ 


(2-26) 


2.4  Added  Force  Term 


The  friction  and  pressure  forces  from  the  banks  do  not  always  describe  ail  the 
forces  which  act  on  the  water.  Structures  such  as  bridge  piers,  navigation  dams,  and 
cofferdams  constrict  the  flow  and  exert  additional  forces  which  oppose  the  flow.  In 
localized  areas  these  forces  can  predominate  and  produce  a  significant  increase  in 
water  surface  elevation  (called  a  "swell  head")  upstream  of  the  structure. 


For  a  differential  distance,  dx,  the  additional  forces  in  the  contraction  produce  a 
swell  head  of  dh,.  This  swell  head  is  only  related  to  the  additional  forces.  The  rate  of 
energy  loss  can  be  expressed  as  a  local  slope: 


dh, 


(2-27) 


The  friction  slope  in  Equation  2-26  can  be  augmented  by  this  term: 


^  ^  djVQ) 
dt  dx 


t  S,  +  S,)  =0 

OX 


(2-28) 


For  steady  flow,  there  are  a  number  of  relationships  for  computation  of  the  swell  head 
upstream  of  a  contraction.  For  navigation  dams,  the  formulas  of  Kindsvater  and  Carter, 
d'Aubuisson  (Chow,  1959),  and  Nagler  were  reviewed  by  Denzel  (1961).  For  bridges, 
the  formulas  of  Yarnell  (WES,  1973)  and  the  Federal  Highway  Administration  (FHWA, 
1978)  are  used.  These  formulas  were  all  determined  by  experimentation  and  can  be 
expressed  in  the  more  general  form: 

,  1/2 

h,  =  a  —  (2-29) 
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where  hi  is  the  head  loss  and  a  is  a  coefficient.  The  coefficient  a  is  a  function  of 
velocity,  depth,  and  the  geometric  properties  of  the  opening,  but  for  simplicity,  it  will 
assumed  to  be  a  constant.  The  location  where  the  velocity  head  is  evaluated  varies 
from  method  to  method.  Generally,  however,  the  velocity  head  is  evaluated  at  the 
tailwater  for  tranquil  flow  and  at  the  headwater  for  supercritical  flow  in  the  contraction. 

If  h,  occurs  over  a  distance  Ax^,  then  h,  =  5',4x^  and  S',,  =  h,/Ax^  where  S„  is  the 
average  slope  over  the  interval  Ax^.  The  result  is  inserted  in  the  finite  difference  form  of 
the  momentum  equation  (Equation  2-26),  yielding: 


A(Q^Ax^  +  QfAXf)  ^  A((31^Q)  ^  ^ 

AfAXg  AXg 


Az 


+  S,  +  Sh 


=  0 


(2-30) 


2.5  Lateral  Influx  of  Momentum 

At  stream  junctions,  the  momentum  of  the  flow  from  a  tributary  enters  the 
receiving  stream  as  well  as  the  mass.  If  this  added  momentum  is  not  included  in  the 
momentum  equation,  the  entering  flow  has  no  momentum  and  must  be  accelerated  by 
the  flow  in  the  river.  The  lack  of  entering  momentum  causes  the  convective 
acceleration  term,  d(VQ)/dx,  to  become  large.  To  balance  the  spatial  change  in 
momentum,  the  water  surface  slope  must  be  large  enough  to  provide  the  force  to 
accelerate  the  fluid.  Thus,  the  water  surface  has  a  drop  across  the  reach  where  the 
flow  enters  creating  backwater  upstream  of  the  junction  on  the  main  stem.  When  the 
tributary  flow  is  large  in  relation  to  that  of  the  receiving  stream,  the  momentum 
exchange  may  be  significant.  The  confluence  of  the  Mississippi  and  Missouri  Rivers  is 
such  a  juncture.  During  a  large  flood,  the  computed  decrease  in  water  surface 
elevation  over  the  Mississippi  reach  is  over  0.5  feet  if  the  influx  of  momentum  is  not 
considered. 

The  entering  momentum  is  given  by: 

=  (2-31) 


where: 


Q,  =  lateral  inflow, 

V,  =  average  velocity  of  lateral  inflow, 

^  =  fraction  of  the  momentum  entering  the  receiving  stream. 


The  entering  momentum  is  added  to  the  right  side  of  Equation  2-30,  hence: 


HOAXq  +  Q/Ax^)  ^  A(p\/Q)  ^  - 

AfAXg  AXg 


Az 

Ax, 


Sf  + 


Ax. 


Equation  2-32  is  only  used  at  stream  junctions  in  a  dendritic  model. 


(2-32) 
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Chapters 


Finite  Difference  Form  of 
the  Unsteady  Flow  Equations 


Equations  2-10  and  2-16  are  nonlinear.  If  the  implicit  finite  difference  scheme  is 
directly  applied,  a  system  of  nonlinear  algebraic  equations  results.  Amain  and  Fang 
(1970),  Fread  (1974,  1976)  and  others  have  solved  the  nonlinear  equations  using  the 
Newton-Raphson  iteration  technique.  Apart  from  being  relatively  slow,  that  iterative 
scheme  can  experience  troublesome  convergence  problems  at  discontinuities  in  the 
river  geometry.  To  avoid  the  nonlinear  solution,  Preissmann  (as  reported  by  Liggett 
and  Cunge,  1975)  and  Chen  (1973)  developed  a  technique  for  linearizing  the 
equations.  This  chapter  describes  how  the  finite  difference  equations  are  linearized  in 
UNET. 


3.1 


Linearized,  Impiicit,  Finite  Difference  Equations 

The  following  assumptions  are  applied: 

1 .  If  f  ’f  »  Af  •Af,  then  Af  •Af=0  (Preissmann  as  reported  by  Liqqett  and 
Cunge,  1975). 

2.  If  sr  =  g(Q,z),  then  Ag  can  be  approximated  by  the  first  term  of  the  Taylor 
Series,  i.e: 


AQj  + 


dz, 


Azj 


(3-1) 


3.  If  At  is  small,  then  certain  variables  can  be  treated  explicitly:  hence  h" 
and  Ahj «  0. 

Assumption  2  is  applied  to  the  friction  slope,  S,  and  the  area,  A.  Assumption  3  is 
applied  to  the  velocity,  V,  in  the  convective  term;  the  velocity  distribution  factor,  /},  the 
equivalent  flow  path,  x;  and  the  flow  distribution  factor,  <p. 

The  finite  difference  approximations  are  listed  term  by  term  for  the  continuity 
equation  in  Table  3-1  and  for  the  momentum  equation  in  Table  3-2. 

If  the  unknown  values  are  grouped  on  the  left-hand  side,  the  following  linear 
equations  result: 

CQIjAQj  +  CZIjAZj  +  CQ2jAQj^^  +  CZ2jAZj^^ 


MQIjAQj  +  MZIjAZj  +  MQ2jAQj^^  +  MZ2jAZj^^ 


-CB, 

(3-2) 

=  MB, 

(3-3) 
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Table  3-1 

Finite  Difference  Approximation  of  the  Terms  in  the  Continuity  Eouation 


Finite  Difference  AoDroxImation 


(Oj.,  -  O,)  +  e(AO,..,  -  AQ) 


0.5  Ax,. 


\  dz  j  I  ‘ 
Q.SLx,,- - '-d. — 


— ^  2  Az.,. 

dz)  j  I  dzjy.1 


Az,  + 


dz  L 


dS\  .  (  dS\  . 

[  dzj ,  ‘  [  dz) , .  ^ 

0.5  Ax,;  ^ ^ - 


Tabie  3-2 

Finite  Difference  Approximation  of  the  Terms  in  the  Momentum  Equation 


Finite  Difference  Approximation 


3(Q,AX,.  Q'AX,)  ^  ^  ^ 


0fAx, 


Apl/Q 


.^[(P\/Q);.,  -  (pi/0),]  +  -  (PVO) 


Ax„ 


g'A  \  ~  *  -~(A^.,  -  Azp  *  OgAA  ~ 

Ax,  Ax,  Ax, 


qA  ( Sf  +  S^)  "^O^SGgfiA [^(ASyry^.|  +  AS^y)  +  (AS^y^.j  +  AS^y) j  +  O.50gf(S^  +  {AAj+ AAj^ 


0.5  (A,-.,  +  Ai) 
0.5  (S„.,  +  S,,) 


-  ^ 

dzjj  ' 

AQ, 

K  dzli  >  [  all  ' 


0.5  (AA,  *  A4;.,) 
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The  values  of  the  coefficients  are  defined  in  Tables  3-3  and  3-4. 


Table  3-3 

Coefficients  for  the  Continuity  Equation 


Coefficient  Value 


CQh 


CZh 


CQ2.. 


CZ2.. 


CBj 


-0 


0.5 

AtAx^j 


<  _/>!  ^ 


Ax„,  + 


^  dAf  ds" 
dz  ^  dz) 


Ax,. 


j 


0 


0.5 


^  Ax  .  + 


dAf  dS 

- -  +  - 


AfAx,,j 

[1  dz)j^, 

-Q,  a 

dz  dz 


AXfj 


Table  3-4 

Coefficients  of  the  Momentum  Equation 


Term  Value 


MQ1. 

/  A..  AX  A  ^ 


MZ7; 


MZ2j 


MB: 


Ax,jAt 


Q; 


V  AXeJJ 


+  O.50d 


I  dz 


CS,  +  S,) 


MQ2.  0.5[Ax„;4i,.,  +  Ax,(1-i|),.,)] 


1  ^ 

-T  R  \/ 

0  ] 

Ax^.AfJ 

PyV1  Vy+1 

*  ^  (S«.i  *  ®»m) 


'  dA> 


Ax 


V  dz, 


Ax. 


QgA 


dK 


V  dz,  y,, 


o  > 


dA 


\  dz)i.\ 


^hj*l 


\  A*i 


(Py.i  C».i  -Py'^  Qy) 


1  ^ 

+ 

gA 

1^1 

{Zj,,  -  Z)  ^  gA{Sf  +  SJ 


O.SGg 


^dA^ 


dz) 


y*i 
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3.2  Flow  Distribution  Factor 

The  distribution  of  flow  between  the  channel  and  floodplain  must  be  determined. 
The  portion  of  the  flow  in  the  channel  is  given  by: 


Q  ■  +  Qf 


(3-4) 


Fread  (1976)  assumed  that  the  friction  slope  is  the  same  for  the  channel  and  floodplain, 
thus  the  distribution  is  given  by  the  ratio  of  conveyance,  i.e.. 


CJ 


*  K„ 


(3-5) 


Equation  3-5  is  used  in  the  UNET  model. 

3.3  Equivalent  Flow  Path 

The  equivalent  flow  path  is  given  by: 

(3-6) 

(3-7) 


Ax.  = 


H-  AfSffLXf 

AS, 


If  we  assume: 


Kc*K, 


where  0  is  the  average  flow  distribution  for  the  reach,  then: 


Ax. 


^pAXg  +  Af  AXf 

A 


(3-8) 


Since  Ax^  is  defined  explicitly: 
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3.4  Boundary  Conditions 

For  a  reach  of  river  there  are  A/ computational  nodes  which  bound  N-1  finite 
difference  cells.  From  these  cells  2/\/-2  finite  difference  equations  can  be  developed. 
Because  there  are  2N  unknowns  {AQ  and  .^zfor  each  node),  two  additional  equations 
are  needed.  These  equations  are  provided  by  the  boundary  conditions  for  each  reach, 
which  for  subcritical  flow,  are  required  at  the  upstream  and  downstream  ends.  For 
supercritical  flow,  boundary  conditions  are  only  required  at  the  upstream  end.  UNET 
only  solves  the  unsteady  flow  equations  for  subcritical  flow  conditions. 

3.4.1  Interior  Boundary  Conditions  (for  Reach  Connections) 

A  network  is  composed  of  a  set  of  M  individual  reaches.  Interior  boundary 
equations  are  required  to  specify  connections  between  reaches.  Depending  on  the 
type  of  reach  junction,  one  of  two  equations  is  used: 

Continuity  of  flow: 

E  =  0  (3-10) 

/=1 

where:  /  =  the  number  of  reaches  connected  at  a  junction, 

Sgi  =  -1  if  I  is  a  connection  to  an  upstream  reach, 

+1  if  I  is  a  connection  to  a  downstream  reach, 

Q,  =  discharge  in  reach  I. 

The  finite  difference  form  of  Equation  3-10  is: 


E  +  MUQ^AQ^  =  MUB„  (3-11) 


Where:  MU,,,  =  0  Sg,, 

MUQ„=  0SgK, 

mub„  =  - 1  s^Q, 

/=1 

Continuity  of  stage: 

4  =  (3-12) 

where  z^,  the  stage  at  the  boundary  of  reach  k,  is  set  equal  to  z^,  a  stage  common  to  all 
stage  boundary  conditions  at  the  junction  of  interest.  The  finite  difference  form  of 
Equation  3-12  is: 

-  MU^Az^  =  MUB„  (3-13) 
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where:  MUZ^  =  0, 

MU^  =  0, 

MUB„  =  z,-Zk. 

With  reference  to  Figure  3-1 ,  UNET  uses  the  following  strategy  to  apply  the 
reach  connection  boundary  condition  equations: 

•  Apply  flow  continuity  to  reaches  upstream  of  flow  splits  and  downstream 
of  flow  combinations  (reach  1  in  Figure  3-1).  Only  one  flow  boundary 
equation  is  used  per  junction. 

•  Apply  stage  continuity  for  all  other  reaches  (reaches  2  and  3  in 
Figure  3-1).  is  computed  as  the  stage  corresponding  to  the  flow  in 
reach  1 .  Therefore,  stage  in  reaches  2  and  3  will  be  set  equal  to  Z^. 

3.4.2  Upstream  Boundary  Conditions 

Upstream  boundary  conditions  are  required  at  the  upstream  end  of  all  reaches 
which  are  not  connected  to  other  reaches  or  storage  areas.  An  upstream  boundary 
condition  is  applied  as  a  flow  hydrograph  of  discharge  versus  time.  The  equation  of  a 
flow  hydrograph  for  reach  m  is: 

LOr  =  o,"  -  Q,  (3-14) 

where  /c  is  the  upstream  node  of  reach  m.  The  finite  difference  form  of  Equation  3-10 
is: 

MUQ^MQ^  =  MUB^  (3-15) 

where:  MUQ^  =  1, 

MUB^  =  or'  -  Q ". 
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3.4.3  Downstream  Boundary  Conditions 

Downstream  boundary  conditions  are  required  at  the  downstream  end  of  all 
reaches  which  are  not  connected  to  other  reaches  or  storage  areas.  Four  types  of 
downstream  boundary  condition  can  be  specified: 

•  a  stage  hydrograph, 

•  a  flow  hydrograph, 

•  a  single-valued  rating  cun/e, 

•  and,  a  looped  rating  curve  that  is  computed  by  UNET  using  a  simplified 
form  of  the  momentum  equation  and  Manning's  equation. 

Stage  Hydrograph.  A  stage  hydrograph  of  water  surface  elevation  versus  time 
may  be  used  as  the  downstream  boundary  condition  if  the  stream  flows  into  a 
backwater  environment  such  as  an  estuary  or  bay  where  the  water  surface  elevation  is 
governed  by  tidal  fluctuations,  or  where  it  flows  into  a  lake  or  reservoir  of  known 
stage(s).  At  time  step  (n+1)At,  the  boundary  condition  from  the  stage  hydrograph  is 
given  by: 


=  4^'  -  4  (3-16) 

The  finite  difference  form  of  Equation  3-16  is: 

(3-17) 


where:  CDZ^  =  1, 

CDB,  =  -  z,". 

Flow  Hydrograph.  A  flow  hydrograph  may  be  used  as  the  downstream  boundary 
condition  if  recorded  gage  data  is  available  and  the  model  is  being  calibrated  to  a 
specific  flood  event.  At  time  step  (n+1)At,  the  boundary  condition  from  the  flow 
hydrograph  is  given  by  the  finite  difference  equation: 

CDQ^AQ^  =  CDB^  (3-18) 


where:  CDQ„  =  1, 

CDB^  =  -  Q,". 

Single  Valued  Rating  Curve.  The  single  valued  rating  curve  is  a  monotonic 
function  of  stage  and  flow.  An  example  of  this  type  of  curve  is  the  steady,  uniform  flow 
rating  curve.  The  single  valued  rating  curve  can  be  used  to  accurately  describe  the 
stage-flow  relationship  of  free  outfalls  such  as  waterfalls,  or  hydraulic  control  structures 
such  as  spillways,  weirs  or  lock  and  dam  operations.  This  boundary  condition  should 
be  avoided  in  otherwise  free-flowing  streams  as  errors  can  be  introduced  into  the 
solution  far  upstream  of  the  downstream  boundary  location.  Further  advice  is  given  in 
(USAGE,  1993). 
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At  time  (n+1)At{he  boundary  condition  is  given  by: 

On  +  =  O/c-1  +  ^ -  Sk-^)  (3-19) 

^k-^ 

where:  discharge  ordinate, 

=  K‘^  stage  ordinate. 

After  collecting  unknown  terms  on  the  left  side  of  the  equation,  the  finite  difference  form 
of  Equation  3-19  is: 

CDQ^AQ^  +  CDZ^Az^  =  CDB^  (3-20) 


Looped  Rating  Curve  Approximation.  Use  of  Manning's  equation  with  a  time- 
variable  friction  slope  produces  an  approximation  of  the  looped  rating  curve  seen  in 
natural  rivers.  This  type  of  boundary  condition  has  the  advantage  of  being  able  to  pass 
waves  downstream,  but  should  be  used  with  the  understanding  that  the  approximation 
may  not  accurately  reflect  the  true  looped  rating  curve.  Butler  (1991)  found  that  the  use 
of  this  option  in  systems  with  very  flat  slopes  (-0.5  ft/mile)  and  rapidly  rising  flood 
waves  resulted  in  rating  curves  with  almost  no  loop,  essentially  equivalent  to  the  steady 
uniform  flow  rating  curve.  The  example  problems  in  Appendix  D  and  related  sections  in 
Appendices  B  and  C  discuss  how  to  minimize  the  error  introduced  into  the  solutions 
when  applying  rating  curves  as  downstream  boundary  conditions. 

Manning's  equation  may  be  written  as: 

Q  =  K{Sff^  (3-21) 

where  K  represents  the  conveyance  and  S,  is  the  friction  slope. 

Using  the  first  term  of  a  Taylor  series,  this  boundary  condition  at  time  step  (n+1) 
At  can  be  represented  as: 


wnere:  CDQ^  =  0, 


'm 


CDZ^  = 


Ok  Ok-^ 

Ok  ~ 


D,- 


Q„  *  eAQ„  =  K'„(S,„)»=  +  |^eAz„(S,r  (3-22) 

dz^ 

The  finite  difference  form  of  Equation  3-22  is: 
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CDQ„AQ„  •  =  CDB 


m 


(3-23) 


where:  CDQ^  =  0, 

f)K 

CDZ^  = 

dz^ 

CDB^ 
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Chapter  4 

Internal  Boundary  Conditions 

Internal  boundary  conditions  describe  discontinuities  in  the  stage  profile  which 
cannot  be  modeled  using  the  unsteady  flow  equations.  Four  types  of  internal  boundary 
equations  are  allowed: 

1)  Levee  failures  and  storage  interactions; 

2)  Gated  spillways  and  weir  overflow  structures; 

3)  Bridge  and  culvert  hydraulics; 

4)  Pumped  diversions. 


4.1  Levees 

A  levee  is  an  earthen  embankment  which  protects  a  region  of  floodplain  from  the 
floodwaters  of  a  river.  A  levee  offers  complete  protection  until  either  the  embankment 
fails  or  is  overtopped.  Along  most  rivers  in  the  Midwestern  USA,  where  the  floodplains 
are  used  extensively  for  agriculture,  levees  are  the  primary  method  of  flood  protection. 
Generally,  the  protected  areas  are  in  the  tens  of  thousands  of  acres.  A  typical  levee 
system  is  shown  in  Figure  4-1 . 

Levees  can  have  a  significant  impact  on  river  hydraulics.  The  embankments 
restrict  flow  to  a  floodway,  usually  the  channel,  denying  both  the  conveyance  and 
storage  of  the  floodplain  to  the  river  system.  The  overall  impact  of  the  constriction  is  to 
raise  flood  stages  and  discharges  while  limiting  the  areal  extent  of  inundation.  In  1973 
the  Mississippi  River  at  St.  Louis  reached  a  stage  of  43.3  ft  at  a  measured  flow  of 
855,000  ft^s.  In  1 944  a  flow  of  844,000  ft^/s  passed  at  a  stage  of  38.9  ft,  4.4  ft  lower. 
The  Alton  to  Gale  levees  that  were  completed  after  World  War  II  are  the  primary  reason 
for  the  change. 

When  a  levee  fails,  the  protected  area  once  again  becomes  a  part  of  the  river 
system.  A  failure  usually  results  from  sustained  high  river  stages  saturating  the 
embankment.  A  piping  failure  through  a  weakened  embankment,  if  unchecked,  can 
enlarge  into  a  breach.  The  rate  of  enlargement  and  the  final  breach  size  depend  on  the 
soil  strength  and  the  volume  and  velocity  of  the  flow  through  the  breach.  The  flow 
through  the  breach  can  withdraw  a  large  volume  of  water  from  the  river  and  lower  the 
river  water  surface  as  much  as  several  feet.  After  the  interior  has  filled  (which  may  take 
two  or  three  days)  it  acts  as  a  damper,  lessening  changes  in  stage,  in  a  manner  similar 
to  the  natural  floodplain  with  the  flow  interchange  passing  through  the  breach  or  over 
the  top  of  the  embankment. 
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Figure  4-1  Typical  levee  system  along  the  Illinois  River  at  Hardin. 
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4.1.1  Modeling  of  a  Levee 

The  change  in  storage  behind  the  levee  is  given  by  the  following  ordinary 
differential  equation: 


dt 


=  Q. 


dx 


(4-1) 


where:  S 

Qb 

^1 

dx 

Ll 


=  levee  storage, 

=  flow  through  the  breach, 

=  flow  over  the  levee  embankment, 

=  differential  unit  of  levee  length  along  the  embankment, 
=  total  length  of  the  levee  embankment. 


Equation  4-1  must  be  solved  simultaneously  with  the  river  model  -  a  trivial 
problem  so  long  as  the  water  in  the  levee  interior  has  no  impact  on  the  river  flow. 
When  submergence  is  a  factor,  the  stage  within  the  area  protected  by  the  levee 
becomes  part  of  the  simultaneous  solution.  This  situation  lowers  the  efficiency  of  the 
numerical  solution  by  adding  new  equations  to  the  system.  Figure  4-2  illustrates  the 
effect  of  levee  failures  on  downstream  stages. 


For  levees  along  the  Illinois  River,  Barkau  (1981)  developed  an  efficient 
approach  to  this  problem.  At  time  (n+1)dt  the  stage,  is  unknown.  This  stage 
depends,  of  course,  on  the  flow  into  the  levee,  Now,  is  also  dependent  on 

Barkau's  solution  was  to  develop  a  function  which  related  to  Zf'^^  Two 
plausible  values  of  Z"*^  were  assumed  and  the  corresponding  values  of 
computed.  From  these  two  solution  points  a  linear  function  was  developed  which  was 
input  as  a  lateral  inflow  into  the  river  model.  The  river  model  was  solved  and  the  levee 
flow,  could  then  be  updated.  This  solution  worked  well  but  it  slowed  the  overall 
model  computational  speed. 


This  solution  was  thought  to  be  more  elaborate  than  warranted.  Because  the 
breach  geometry  and  evolution  are  seldom  known,  the  computed  breach  flow  would  be 
imprecise  and  the  complex  hydraulics  could  be  simplified.  Therefore,  a  simple 
procedure  was  developed  that  produced  acceptable  results.  It  is  generally  known  how 
long  it  takes  the  protected  area  behind  a  levee  to  fill  and  where  the  breach  will  most 
likely  occur.  From  the  filling  time  a  simple  inflow  hydrograph,  and  hence  the  right  hand 
side  of  Equation  4-1 ,  can  be  estimated.  For  simplicity,  the  area  behind  the  levee  is 
assumed  to  fill  at  a  uniform  rate  until  the  last  time  step  when  the  flow  is  adjusted  so  that 
the  levee  and  the  river  attain  the  same  elevation  (equilibrium).  This  technique  produces 
reasonable  results  with  a  minimum  of  computational  overhead. 
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Figure  4-2  The  1  %  exceedance  event  stage  hydrograph  of  the  Illinois  River  at 

Kingston  Mines  (KNGI2)  with  and  without  the  failure  of  the  agricultural 
levees  along  the  river. 

4.1.2  Solution 

Storage.  Except  for  depressions,  the  land  inside  an  agricultural  levee  is  nearly 
flat.  Therefore,  the  storage  can  be  given  by  simple  linear  function: 

S  =  (4-2; 

where:  A,_  =  surface  area  of  land  protected  by  the  levee, 

=  an  average  depth  of  water  inside  the  levee. 

If  the  water  surface  inside  the  levee  is  nearly  plane,  then: 

Dl  =  z,-  z,,  (4-3] 


where:  Zi_  = 


the  average  water  surface  inside  the  levee, 
the  average  elevation  of  the  land  inside  the  levee. 
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Flow  through  the  levee  during  failure.  Major  levee  systems  seldom  fail  by  being 
overtopped.  This  is  a  catastrophic  failure  which  could  result  in  the  destruction  of  long 
reaches  of  the  embankment.  Before  this  is  allowed  to  occur,  a  breach  would  be  cut  or 
a  low  area  would  be  allowed  to  overtop  and  degrade.  Therefore,  a  breach  is  the 
primary  mode  of  failure. 

At  the  time  of  failure,  the  storage  to  be  filled  is: 

^LT  -  \{Zbr  -  Zlo)  (4-4) 

Where  is  the  average  water  surface  elevation  of  the  river  at  the  breach.  It  is 
assumed  that  the  area  behind  the  levee  will  fill  in  time  Tf.  To  simplify  the  computations, 
the  flow  is  assumed  constant,  hence: 


(4-5) 


where  is  the  constant  flow  required  to  fill  the  storage  S^y-  in  time  Tf.  After  each  time 
step,  the  stage  behind  the  levee  is  updated: 


6f 


(4-6) 


When  the  storage  area  is  almost  full,  i.e.  when  (n  is  now  the  current  time  step): 


then: 


‘■BR 


<  Z, 


Qf_  5f 


0,  = 


(4-7) 


(4-8) 


Flow  to  and  from  a  full  storage  area.  After  the  storage  area  is  full,  an  exchange 
of  flow  can  either  go  through  the  breach  or  over  the  levee  crest,  although  in  practice  the 
latter  is  to  be  avoided.  The  exchange  maintains  the  water  surface  inside  the  levee  and 
the  river  stage  at  equilibrium.  Hence,  for  flow  through  the  breach: 

Ot  =  (ZBH  -7,")^  (4-9) 

ot 
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and  for  flow  over  the  levee  crest: 

Q  =  (  7^*^  —  7^\  _ — 

or 

(4-10) 

where  is  the  river  elevation  at  the  midpoint  along  the  levee  length. 

4.1.3  Levee  Flow  as  a  Lateral  Inflow  In  the  Continuity  Equation 

The  flow  through  the  levee  is  added  into  the  river  model  as  a  lateral  inflow  in  the 
continuity  equation.  While  the  levee  is  filling,  the  coefficients  for  the  continuity  equation 
are  augmented  in  the  following  manner: 

(4-11) 

then: 

0, 

CB,  =  CB:  -  ^ 

‘  ^  Ax  . 

(4-12) 

where  is  given  by  Equation  4-5  and  /  is  the  number  of  the  river  reach  which  encloses 
the  breach. 

After  the  storage  area  has  filled,  the  coefficients  for  the  continuity  equation  are 
augmented  in  the  following  manner: 

^WR  ^ 

(4-13) 

then: 

CZ1,  -  CZh  +  0.5 
‘  ‘  Ax  . 

(4-14) 

A, 

CZ2,  =  CZ2i  +  0.5 
‘  '  Ax  . 

(4-15) 

else: 

A,  x^, 

CZ1.  =  CZU  +  0.5 

^  ^  Ax  L 

(4-16) 
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CZ2^  =  CZ2^  +  0.5 


Xc 


i., 


(4-17) 


where  Zj  is  the  average  elevation  of  the  levee  crest  and  fc  is  the  set  of  all  cells  along 
the  levee  frontage. 


4.2  Flow  over  a  Spillway 

A  spillway  controls  the  water  surface  elevation  and  flow  in  the  channel  or  it 
diverts  flow  away  from  the  channel.  The  diverted  flow  can  pass  completely  out  of  the 
system  or  into  another  channel  reach.  This  section  presents  the  equations  for  spillway 
computations. 


4.2.1  Equations  for  Fiow  over  a  Spillway  Structure 

The  general  equation  for  free  and  submerged  discharge  from  spillway  with  a 
tainter  gate  is: 

Q^  =  CWA^B^H^  (4-18) 


where:  A 
B 
C 
W 
H 

K 

a,  (3  and  q 


=  trunnion  height, 

=  gate  opening, 

=  a  coefficient, 

=  gate  width, 

=  Z,-KZ,-(1-K)Z3p, 

=  headwater  elevation, 

=  tailwater  elevation, 

=  1  for  submerged  flow  and  0  for  free  flow, 
=  spillway  elevation, 

=  exponents. 


Equation  4-18  is  a  regression  equation  which  was  proposed  by  the  U.S.  Bureau 
of  Reclamation  to  describe  the  rating  for  control  structures  on  the  Grand  Canal  in 
Arizona.  All  dimensions  are  in  U.S.  Customary  units.  Negative  flow  occurs  when  Z^Z^j. 

Submerged  flow  is  defined  to  occur  when: 


>  2/3 


(4-19) 


When  the  gate  no  longer  controls  the  flow,  which  is  assumed  to  occur  when  B  =  0.8H, 
the  flow  is  computed  by  the  weir  flow  equation: 
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I 

Q^=C^FW  {C1  -  /C)  Z,  +  KZ,  -  (4-20) 


where: 


F 

F 

Ate 


=  weir  flow  coefficient  (see  Section  4.3.2  for  the  relationship  between  the 
free  and  submerged  loss  coefficients), 

=  3  {1  -  (Z,  -  Z3p)  /  (Z„  -  Z^p)}  whenK  =  1, 

=  1  when  K  =  0, 

=  0.8  H,  the  flow  calculated  by  equations  4-18  and  4-20  must  be  the  same. 


Hence: 


-K)Z„*KZ,-Z^]  (4-21) 


and: 


'wc 


[CA^)  BP 

F{{^-K)Z^^  KZ,-  Z,,] 


(4-22) 


where  C^c 's  the  computed  value  at  0.8H. 

When  B>H,  the  gates  have  no  contact  with  the  flow  and  the  weir  coefficients  are 
their  normal  values.  For  a  concrete  spillway  is  about  4.  If  the  is  the  assumed 
value,  a  linear  interpolation  is  assumed  between  0.8H>B>H,  such  that: 


Cw  -  + 


(  ^WA  ^wc ) 
0.2  H 


{B  -  0.8H) 


(4-23) 


4.2.2  Overflow  Weir 

In  addition  to  the  gated  spillway,  the  spillway  can  include  uncontrolled  overflow 
weirs.  Equation  4-20  is  used  in  the  weir  flow  calculation. 

4.2.3  Elevation  Controlled  Gate 

The  elevation  controlled  gate  is  regulated  by  the  upstream  pool  elevation.  When 
the  pool  elevation  exceeds  a  specified  level,  ZECOPEN,  the  gate  begins  to  open  at  a 
rate  of  ECOPRATE.  The  gate  continues  to  open  until  a  maximum  opening  of 
ECMXOPENING.  When  the  pool  elevation  falls  below,  ZECCLOSE,  the  gate  begins  to 
close  at  a  rate  of  ECCLRATE. 
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The  elevation  controlled  gate  option  is  designed  to  simulate  the  failure  of  an 
embankment.  The  orifice  type  equation  for  flow  under  a  fainter  gate  is  identical  to  the 
orifice  equation  for  a  piping  failure  of  an  embankment  (Fread,  1985).  For  an 
overtopping  failure  and  an  eroding  embankment,  use  of  an  opening  gate  is  imprecise, 
but  the  imprecision  is  short  lived  because  once  the  gate  is  open,  the  flow  through  the 
breach  is  governed  by  the  weir  flow  equations. 

The  elevation  controlled  gate  is  an  internal  boundary  condition  which  is  specified 
in  the  *.BC  file  for  both  lateral  and  in-line  spillways.  Figure  4-4  demonstrates  the 
elevation  controlled  gate  simulating  the  failure  of  the  fuse  plug  for  the  New  Madrid 
Floodway.  The  fuse  plug  is  opened  by  explosives;  therefore,  the  rate  of  failure  is  nearly 
instantaneous.  Because,  for  the  Lower  Mississippi  River,  the  time  step  is  24  hours,  the 
failure  occurs  within  one  time  step  and  there  is  no  inaccuracy. 


Figure  4-4  Demonstration  of  the  elevation  controlled  gate.  The  gate  simulates  the 
failure  of  the  fuse  plug  at  the  New  Madrid  Floodway  at  a  stage  of  48.5  ft 


and  the  subsequent  closure  of  the  fuse  plug  at  a  stage  of  45.5  ft. 
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4.2.4  Numerical  Analysis 

In  the  implicit  finite  difference  scheme,  the  discharge  over  spillway  ka\  time 
(n+d)At  is: 


Dr®  =  d;  .  e-AD, 


(4-24) 


where:  9  =  the  implicit  weighting  coefficient, 


AD,  =  -  D,", 


-  Dgk  +  D^k  -  the  sum  of  spillway  and  weir  flow. 


Assume  that  the  nonlinear  term  AD  can  approximated  by  the  first  order  Taylor 
expansion,  then: 


dD,  dD,  dD, 

=  — -AB,  +  — !aZ„  +  — 


(4-25) 


in  which  the  superscript  n  has  been  dropped.  For  gated  spillway  flow: 


dDsk  -K  D,, 


(4-26) 


dD^,  Pk  d, 


k  ^sk 


(4-27) 


For  weir  flow: 


Dsk^k 


(4-28) 


(1-/C)Z„  +  /CZ, -Z^ 


0.5  kh: 


(4-29) 
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i^-K) 

p-K)Z^^  KZ,-  Zsp] 


+  0.5  Hi 


(4-30) 


where  the  derivatives  of  Fand  B  are  neglected. 
For  a  lateral  spillway,  the  continuity  equation: 


CQIj  AQ,.  + 


CZ1  AZ,  + 


CQ2i  ^Qi., 


CZS^AZ;.,  =  CB,, 


(4-31) 


is  modified  as  foilows: 


CZ1j  =  CZj  +  —  ^ 
'  ^  Ax,  dZj 


(4-32) 


CZ1j., 


cz, 


7+1 


,  e  dP, 


(4-33) 


CBj  =  CBj  - 


+  0 


dB^ 


AS, 


9 

Ax, 


(4-34) 


in  which  4lx,  is  the  equivalent  flow  distance. 


If  the  spillway  is  in  the  channel  controlling  the  flow,  the  continuity  and  momentum 
equations  are  replaced.  The  continuity  equation  is: 


Qj  +  5Qy  =  +  6Qy 


and: 


CQIj  =  0 


(4-35) 


(4-36) 
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CZ1j  =  0 


CQ2j  =  -0 


CZ2j  -  0 


CB, 


9^+1 


Q 

j 


The  momentum  equation  is  replaced  by: 


Qj  +  0  6Qj  =  0^  +  0 


and: 


dD. 


MZ1j  =  0 


dZ,. 


AZj 


MQ1j  =  0 


MQ2j  =  0 


MBj  =  D,-Q,. 


da 


dB^ 


(4-37) 

(4-38) 

(4-39) 

(4-40) 


(4-41) 

(4-42) 

(4-43) 

(4-44) 

(4-45) 

(4-46) 
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4.3  Modeling  Bridges,  Culverts,  and  Low  Water  Dams 

Bridges,  culverts,  and  low  water  dams  restrict  the  flow  to  a  contracted  opening. 
These  structures  can  be  treated  in  the  model  as  interior  boundary  conditions.  The 
procedure  computes  the  change  in  water  surface  from  the  headwater  section  to  the 
tailwater  section.  The  flow  is  assumed  the  same  at  the  headwater  and  tailwater 
sections. 

Two  types  of  energy  loss  functions  can  be  used.  The  first  employs  Yarnell's 
equation  for  swell  head  through  pile  bents;  the  second  uses  a  family  of  free  and 
submerged  rating  curves  computed  from  an  outside  source. 

4.3.1  Yarnell's  Equation 

The  bridge  piers  are  assumed  to  be  located  between  nodes  y  and  j+1.  Yarnell's 
equation  is  (HEC,  1990d  and  Henderson,  1966): 

H  =  2/C(K' +  lOco  -  0.6)  (a  +  15a^) (4-47) 

2sr 


where:  H 
K 

CO 

a 


=  difference  in  water  surface  from  the  upstream  and  the  downstream  sides 
of  the  bridge, 

=  Pier  slope  coefficient, 

=  Vnj+i  /  ratio  of  downstream  velocity  head  to  the  downstream  depth, 

=  ratio  of  obstructed  area  to  total  unobstructed  area. 


To  simplify  the  analysis,  it  is  assumed  that  cr  equals  the  ratio  of  the  obstructed 
top  width  to  the  total  unobstructed  top  width. 


Equation  4-47  can  be  expressed  as  the  standard  head  loss  equation: 

H  =  r[V^  (4-48) 

in  which  /y  is  a  head  loss  coefficient  and  is  the  velocity  head  at  j+1. 

In  the  implicit  finite  difference  scheme,  at  time  t=(n+6)At 

H  ^  AH  =  r]V„  ^  Ain  V„)  (4-49) 

If  the  change  in  head  loss  is  approximated  by  a  first  order  Taylor  approximation,  then: 


AH  = 


in 

aZ; 


n 


AZr 


an 


dV, 


H 


an  , 


3z;,J 


(4-50) 


To  simplify  the  analysis,  we  assume  that  the  coefficient,  rj,  is  constant  over  the  time 
step,  hence: 
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dr\  ^  an  ^  an 
dZj„  '  30,,,  ■  3Z,., 


(4-51) 


dV„ 

AH  =  - -AQ,,,  *  — -AZ,,. 

sa,„  sZj., 


The  (derivatives  of  V^,  are: 


SVh  _  2Vh 
SOj,,  Qj., 


(4-52) 


(4-53) 


where:  Au^  is  the  area  at  j’+l. 


SVh  _  -ZVh 

'^/+1  ^'^■+1 


(4-54) 


The  following  term  is  a(d(de(d  into  the  momentum  equation  as  an  ad(de(d  force  term: 

^  H  +  AH 


where  Ax^  is  the  equivalent  flow  (distance.  The  linear  momentum  equation  is: 

MQIjAQj  +  MZIjAZj  +  MQZjAQj^^  +  MZ2jAZj^^  =  MBj 

MQ2:  •  MQ2.  *  — 

'  '  30/., 

where  /corresponds  to  location  2.  The  coefficients  are  augmented  by: 

SVh  1 

_  AA-rn  n  i 


MZ2,  =  MZ2,  + 


(4-55) 


(4-56) 


(4-57) 


(4-58) 


MBj  =  MBj 


(4-59) 


4.3.2  Free  and  Submerged  Rating  Curves 

Bridge  and  culvert  structures  have  the  typical  rating  function  which  is  shown  in 
Figure  4-5.  The  free  flow  rating  function  describes  the  flow  if  tailwater  submergence 
does  not  occur,  such  as  free  flow  over  a  weir.  Above  the  free  flow  rating  are  a  family  of 
submerged  flow  rating  curves,  one  for  each  tailwater  elevation. 
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The  UNET  model  simulates,  submerged  and  free  flow  differently.  For  submerged 
flow,  the  momentum  equation  is  augmented  by  the  added  slope  term: 


where: 


S, 

AH 

Ax 


s,= 


AH 

Ax 


(4-60) 


added  slope  term, 

swell  head  from  headwater  to  tailwater, 

distance  between  headwater  and  tailwater  cross  sections. 


The  added  slope  term  is  simply  the  swell  head  divided  by  the  distance. 

The  submerged  head  loss  can  be  computed  in  two  ways.  First,  the  UNET 
program  can  store  the  family  of  submerged  rating  curves  and  interpolate  the  swell  head 
directly,  this  is  the  recommended  and  default  procedure.  Secondly,  the  swell  head  can 
be  computed  from  a  set  of  exponential  equations  which  are  fitted  to  the  family  of 
submerged  rating  curves. 


Figure  4-5  Family  of  free  and  submerged  rating  curves. 
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For  each  bridge  or  culvert  crossing,  a  set  of  three  exponential  equations  may  be 
fitted  using  least  squares  regression.  The  equations  correspond  to  three  regions 
(Figure  6-1): 


1)  Open  channel  flow  region  -  from  the  downstream  invert  to  the  downstream 
low  chord  or  crown  of  the  culvert. 

2)  Pressure  flow  -  from  the  downstream  low  chord  to  the  low  point  in  the  weir 
profile. 

3)  Pressure  and  weir  flow  -  from  the  low  point  of  the  weir  profile  and  upward. 

The  general  form  of  the  exponential  equation  is: 

AH  =  aQ'^A^  (4-61) 

where:  AH  =  swell  head  from  headwater  to  tailwater, 

Q  =  flow, 

Aj  =  area  in  the  tailwater, 
a,  b,  and  c  =  regression  parameters. 

The  free  flow  rating  function  is  applied  by  table  look  up.  Free  flow  occurs  when 
the  elevation  computed  from  the  submerged  flow  rating  function  is  below  the  elevation 
computed  from  the  free  flow  rating  function. 


4.3.3  Numerical  Analysis 


In  the  UNET  program,  values  of  stage,  Zj,  and  flow,  Qj,  are  known  at  the  nAttlme 
level  and  unknown  at  the  (n+1)At\ime  level.  UNET  applies  a  linearized,  implicit  finite 
difference  scheme  to  solve  for  the  unknowns  at  the  (n+1)Att\n\e  level;  therefore  a  set  of 
linear  equations  is  solved  at  each  time  step.  The  equations  are  linearized  using  the  first 
order  Taylor  approximation;  higher  order  derivatives  are  assumed  to  be  zero.  For 
submerged  flow  the  coefficients  of  the  momentum  equations  are  augmented  as  follows: 


If  q,,  >  0: 


If  Oy^,<  0,  then: 


dS 

MQ2,  =  MQ2i  +  - 

‘  ’  dQ,, 

^  c 

MZ2:  =  MZ2,  +  — 

‘  ‘  dZ., 


MBj  =  MBj  + 


MYtL 


dS 

MQ1:  =  MQ1,  +  — ^ 
‘  ’  dO, 


(4-62) 

(4-63) 

(4-64) 

(4-65) 
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‘  dS 

MZ1:  -  MZ1:  -  ^ 

‘  ‘  dZj 

(4-66) 

MBj  =  MBj  - 

(4-67) 

Free  flow  is  given  by: 

B(Z^)  *  =  0.6(  q-  .  q., )  *  0.59(AO,  *  AO,., ) 

aZj 

(4-68) 

where  R  is  the  free  flow  rating  function.  The  coefficients  for  the  momentum  equation 
are: 

+ 

IV 

p 

MQ1j  =  MQ2j  =  -0.5  0 

(4-69) 

MZ1:  =  0 
^  c/z;. 

(4-70) 

O 

It 

(4-71) 

If  q.,  <  0: 

MB,  =  0.5(0,  +  0,.,) 

(4-72) 

MOJ,  =  MQ2i  =  -0.58 

(4-73) 

MZ2,  =  -6  — 

(4-74) 

MZ1i  =  0 

(4-75) 

MBj  =  0.5(0,  +  0,„) 

(4-76) 

4.4  Flow  Diversions 

The  UNET  program  simulates  two  types  of  flow  diversions  -  a  pumped  diversion 
and  a  diversion  of  flow  into  groundwater. 
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4.4.1  Pumped  Diversion 

The  pumped  diversion  diverts  water  from: 

1)  One  river  reach  to  another  river  reach. 

2)  A  river  reach  to  a  storage  area. 

3)  A  river  reach  to  outside  of  the  model. 

4)  A  storage  area  to  another  storage  area. 

The  magnitude  of  the  pumped  diversion  is  controlled  by  a  pumping  sequence. 
The  pumping  sequence  consists  of  a  staging  elevation  where  the  pumps  are  started 
and  a  pumping  capacity  at  that  point.  The  pumping  capacity  remains  unchanged  until 
the  next  staging  elevation  or  a  shutdown  elevation  is  reached.  This  type  of  rating 
function  is  illustrated  in  Figure  4-6.  The  pump  characteristics  are  not  modeled  directly. 

The  pumped  diversion  is  governed  by  the  PD  data  record  which  is  placed  in  the 
cross-section  file  between  the  two  cross  sections  where  the  diversion  occurs.  If  the 
diversion  is  between  storage  areas  the  PD  record  can  be  placed  anywhere  after  the  two 
storage  areas  have  been  defined  by  SA  records. 

The  pumped  diversion  hydrograph  is  automatically  written  to  DSS  with  the  B  part 

either: 

1)  The  connecting  river  miles. 

2)  The  connecting  river  mile  and  storage  area. 

3)  The  connecting  storage  areas. 


C 

o 

"5 

> 

(U 


Pump  stortup 


Pump  shutdown 


1 


Olschorge  is  constont  at  Q1  from  Z1  to  Z2, 


Flow 


Figure  4-6  Pump  station  capacity  curve  for  a  pumped  diversion. 
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4.4.2  Groundwater  Interchange. 

The  UNET  program  can  simulate  interchange  of  water  between  the  river  and  the 
groundwater  aquifer.  The  groundwater  algorithm  is  simplistic;  simulating  flow  in  only 
one  direction,  laterally,  perpendicular  to  the  river.  The  groundwater  aquifer  is  assumed 
to  be  very  large  such  that  the  interchange  of  water  with  the  river  has  no  impact  on  the 
groundwater  level. 

The  groundwater  interflow  is  described  by  Darcy's  equation: 


Og^j  =  (4-77) 


where: 

k 

=  Darcy's  coefficient. 

As 

=  flow  area  perpendicular  to  the  direction  of  flow. 

H 

=  piezometric  head. 

L 

=  characteristic  length  over  which  the  piezometric  gradient  acts. 

In  our  simplified  river  modeling  problem,  we  assume  that  the  flow  area  is  the 
wetted  surface  area  between  cross  sections  J  and  J+1.  If  the  elevation  of  the 
groundwater  table  is  below  the  channel  invert,  the  wetted  surface  area  is  given  by: 


=  0-5  {T^  +  (4-78) 

in  which  is  the  top  width  at  cross  section  j  and  DXg  is  the  equivalent  flow  distance.  If 

the  groundwater  table  is  above  the  channel  invert,  the  wetted  surface  of  the  cross 
section  is  the  sum  of  the  length  of  the  sides  of  the  channel  and  the  wetted  top  width  of 
the  overbank;  hence,  the  wetted  surface  area  is: 

=  2IQMZ1  Z,.,)  -  (4-79) 

where:  T„j  =  valley  top  width  for  cross  section  j. 

Dx^  =  channel  distance. 

Dx^  =  valley  distance. 

=  elevation  of  the  aquifer. 

The  change  in  piezometric  head  is  given  by: 

AH  =  Z  -  MAX{Z^^Z,J  (4-80) 

in  which  Zis  the  river  elevation,  z=o.5(z;.+2;.,,;andz;.„,  is  the  elevation  of  the  cross 
section  invert,  =  0.5  (Z,„,j+ 
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The  estimation  of  the  distan.ce  L  over  which  the  head  acts  is  needs  to  be 
approximated.  In  reality  this  distance  would  vary  with  time  being  dependent  upon  the 
relative  orientation  and  magnitude  of  the  difference  between  the  heads.  Hence,  for  a 
high  head  differential,  the  distance  would  be  longer  and  for  lower  head  differentials  the 
distance  would  be  shorter;  see  Figure  4-7.  For  use  by  UNET,  the  distance  is  assumed 
to  be  a  constant. 


Figure  4-7  Effective  length  for  the  computation  of  piezometric  head  differential. 


The  groundwater  interflow  is  a  boundary  condition  which  is  applied  to  the  model. 
The  interflow  is  computed  from  the  stages  that  were  determined  over  the  last  time  step 
and  the  observed  groundwater  stage  and  the  interflow  is  applied  explicitly  as  a  lateral 
inflow  or  outflow  over  the  next  time  step. 
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Chapter  5 

Modeling  of  Bridge  Hydraulics 


Bridge  crossings  consist  of  two  components:  The  bridge  structure  (piers  and 
superstructure)  and  the  roadway  approach  embankments.  The  roadway  embankments 
block  the  floodplain,  concentrating  the  flow  at  the  bridge  opening.  The  bridge  piers  and 
superstructure  obstruct  the  flow,  exerting  a  force  in  the  upstream  direction  which  must 
be  overcome  by  a  swell  head  (energy  loss).  During  large  floods,  the  embankments 
may  overtop,  lessening  the  flow  through  the  bridge  opening  and  therefore  reducing  the 
swell  head. 

The  UNET  program  has  two  procedures  for  modeling  bridge  crossings.  The  first 
procedure,  the  normal  bridge  procedure,  subtracts  the  area  of  the  embankments  and 
bridge  structure  from  the  cross-sectional  area.  The  wetted  perimeter  is  also  increased 
by  the  wetted  length  of  the  piers  and  the  bridge  superstructure;  hence,  the  conveyance 
is  decreased.  The  UNET  normal  bridge  procedure  is  similar  to  the  normal  bridge 
procedure  used  by  the  HEC-2  backwater  program.  The  cross  section  of  the  bridge 
structure  and  the  embankments  are  specified  on  the  BT  records  (see  Appendix  B).  The 
area  of  the  cross  section  is  reduced  by  the  area  of  the  bridge  structure  and  the  wetted 
perimeter  of  the  cross  section  is  increased  by  the  wetted  perimeter  of  the  structure. 

The  normal  bridge  procedure  is  preferred  when  the  embankments  are  low  and  greatly 
submerged.  These  crossings  are  commonly  called  perched  bridges. 

The  second  procedure,  the  special  bridge  procedure,  models  the  bridge  crossing 
as  an  interior  boundary  condition  which  substitutes  a  family  of  free  and  submerged 
rating  curves  for  the  unsteady  flow  equations.  The  free  flow  rating  function  describes 
the  stage-discharge  relation  for  the  structure  if  the  submergence  from  the  tailwater  is 
not  a  factor.  The  family  of  submerged  flow  rating  curves  relates  the  tailwater  elevation 
and  the  flow  to  the  swell  head  generated  upstream  of  the  structure.  The  insertion  of  an 
interior  boundary  condition  using  a  family  of  rating  curves  is  described  in  Chapter  4. 

The  key  to  the  application  of  the  special  bridge  procedure  is  the  calculation  of 
the  family  of  rating  curves.  Bridge  flow  can  be  divided  into  three  regions:  low  flow 
when  the  flow  is  concentrated  in  the  bridge  opening  and  the  flow  is  resisted  only  by  the 
bridge  piers;  pressure  flow  when  the  bridge  chords  are  submerged;  and  weir  flow 
when  the  approach  embankments  are  overtopped.  These  flow  regions  can  be 
combined;  i.e.,  there  can  be  low  flow  and  weir  flow,  pressure  flow  and  weir  flow,  etc. 

For  each  flow  region,  empirical  equations  have  been  derived  which  relate  the 
geometric,  flow,  and  tailwater  stage  parameters  to  the  swell  head.  The  principal 
procedures  for  modeling  bridge  hydraulics  are: 

1)  The  HEC-2,  "Water  Surface  Profiles,"  special  bridge  procedure  (HEC, 

1990d). 
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2)  The  procedure  presented  in  Hydraulics  of  Bridge  Waterways  (FHWA,  1978). 

3)  The  WSPRO  bridge  procedure,  (FHWA,  1986). 

Each  of  these  procedures  uses  different  equations  and  can  produce  different  results. 
Each  procedure  will  produce  adequate  results,  however,  when  applied  in  a  skillful 
manner. 

5.1  Free  Flow 

5.1.1  Low  Flow 

Free  flow  through  the  bridge  constriction  assumes  that  critical  depth  occurs 
within  the  bridge  constriction  until  the  occurrence  of  pressure  flow,  which  is  given  by 
equation  5-5.  Free  flow  is  modeled  using  a  weir-type  of  equation  with  additional  head 
losses  from  the  piers.  Two  formulae  are  available.  The  FHWA  (1978)  suggested  a 
formula  based  on  critical  depth  in  the  constriction  and  an  entrance  loss.  This 
procedure,  which  does  not  consider  the  width  of  the  piers,  was  qualified  by  the  FHWA 
as  tentative.  Yarnell  (as  described  in  WES,  1973)  proposed  a  simple  entrance  loss 
function  which  included  effects  of  the  piers.  The  Yarnell  procedure  is  used  in  the  UNET 
program. 


Two  cross  sections  are  assumed;  cross  section  1  is  just  upstream  of  the  bridge 
and  cross  section  2  within  the  bridge  constriction.  The  cross  sections  are  identical 
except  for  the  area  occupied  by  the  piers  within  the  constriction.  The  energy  equation 
is  written  between  the  two  cross  sections: 


Yl 

29 


a 


29 


+  D2  + 


h, 


(5-1) 


Critical  depth  is  assumed  at  section  2.  At  critical  depth,  the  velocity  head  is  one-half 
the  hydraulic  depth: 


—  =  0.5  (5-2) 

29 


where: 

Dc 

Ac 


=  velocity  head, 

=  Ac  =  hydraulic  depth  at  critical  depth, 
=  area  at  critical  depth, 

=  top  width  at  critical  depth. 
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The  head  loss  is  estimated  by  the  Yarnell  equation  assuming  critical  depth  in  the 
constriction: 

'  f/4  P  \ 

h,  =  Cy,  5.5 M  +.08  ^  (5-3) 

where:  Cy^  =  Yarnell  pier  loss  coefficient;  from  1  for  round  nosed  piers  to  5  for  square 
nosed  piers, 

Ap  =  area  of  the  piers. 

An  iterative  procedure  is  used  to  solve  equations  5-1  to  5-3  for  flow  associated 
with  an  upstream  stage.  For  each  stage,  the  following  procedure  is  used: 

1 )  Compute  the  hydraulic  depth  and  area  at  1 . 

2)  Assume  an  initial  stage  at  2. 

3)  Compute  the  hydraulic  depth  and  area  at  2. 

4)  Compute  the  discharge  using  equation  5-2. 

5)  Solve  equation  5-1  for  the  stage  at  1 . 

6)  If  the  computed  stage  at  1  is  within  a  tolerance,  the  computation  is  finished. 

7)  Make  a  new  estimate  of  the  stage  at  2  and  go  to  step  3. 

5.1.2  Pressure  Flow 

Pressure  flow  is  assumed  to  occur  when: 


_hw - o  ^  -,  3 

4  -  4 


(5-4) 


where:  =  headwater  elevation, 

Zic  =  elevation  of  the  low  chord, 

Zg  =  invert  elevation  of  the  cross  section. 

The  critical  ratio  of  1 .3  parallels  the  accepted  criterion  used  to  separate  open  channel 
and  pressure  flow  for  culverts.  It  is  a  purely  empirical  ratio,  without  basis  in  theory. 

Pressure  flow  is  given  by  a  sluice  gate  equation  (FHWA,  1978): 

Q  =  ^  -  0.5(4  -  4)|  (5-5) 

in  which  is  the  pressure  flow  coefficient;  about  0.5  (FHWA,  1978). 
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5.1.3  Weir  Flow 

Weir  flow  is  given  by  equation  4-18. 

5.2  Submerged  Flow 

5.2.1  Low  Flow  using  Yarnell's  Equation 

Yarnell's  equation  is  used  in  the  HEC-2  special  bridge  routine  to  estimate  the 
swell  head  upstream  of  pile  bents.  The  Yarnell  equation  is  (HEC,  1990d  and 
Henderson,  1966): 

vt 

AH  -  2K{K  +  lOco  -  0.6)  (a  +  15a^)  —  (5-6) 

2Sf 


where:  AH 
K 

CO 

a 


=  difference  in  water  surface  from  the  upstream  and  downstream  sides  of 
the  bridge, 

=  pier  slope  coefficient, 

=  the  ratio  of  the  downstream  velocity  head  to  the  depth, 

=  ratio  of  obstructed  area  to  total  unobstructed  area. 

=  the  velocity  downstream  of  the  bridge. 


It  is  assumed  that  a  can  be  approximated  by  the  ratio  of  the  obstructed  top  width 
to  the  total  unobstructed  top  width. 


5.2.2  Pressure  Flow 

Pressure  flow  is  assumed  to  occur  when  the  taiiwater  elevation  exceeds  the  low 
bridge  chord  elevation.  Pressure  flow  is  given  by  a  submerged  sluice  gate  equation: 


^tw  ^  ^Ic 


(5-7) 


a  =  K^^/^  A 


^hw 


v; 


hw 


2g 


-  Z, 


tw 


0.5 


(5-8) 


in  which  Kp^  is  discharge  coefficient;  0.7  to  0.9  (FHWA,1978). 


5.2.3  Weir  Flow 

Weir  flow  is  given  by  equation  4-18. 
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5.3  Strategy  for  Computing  Free  and  Submerged  Flow  Rating  Curves 

Free  and  submerged  rating  curves  are  computed  for  the  bridge-weir  system  for  a 
range  of  headwater  and  tailwater  elevations  entered  by  the  user.  The  free  flow  rating 
curve  is  computed  first,  assuming  a  tailwater  elevation  below  the  downstream  invert. 
The  rating  curve  is  currently  defined  by  50  points.  Then,  for  each  of  50  tailwater 
elevations  uniformly  distributed  over  the  entered  tailwater  range,  a  submerged  flow 
rating  curve  is  computed.  Each  submerged  flow  rating  curve  is  defined  by  a  maximum 
of  50  points.  The  headwater  elevations  are  chosen  such  that  they  lie  in  the  feasible 
range  indicated  by  the  three  flow  regions  (see  Section  5.1).  If  optionally  selected,  three 
exponential  equations  (equation  4-61),  which  correspond  to  the  three  flow  regions,  may 
be  derived  from  the  50  submerged  flow  rating  curves,  using  least  squares. 
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Chapter  6 

Modeling  of  Culverts 


Culverts  restrict  the  flow  to  a  small  opening  through  an  embankment.  The 
constriction  generates  a  head  loss  (swell  head)  which,  for  severe  restrictions,  can  be 
several  feet.  During  high  flow,  the  embankment  may  be  overtopped  and  act  as  a  weir. 

The  UNET  system  models  culverts  using  a  set  of  free  and  submerged  flow  rating 
curves,  as  described  in  Chapter  4.  The  CSECT  module  has  the  capability  of  calculating 
the  free  and  submerged  flow  rating  curves  for  a  system  of  up  to  five  parallel  culverts 
and  four  overflow  weirs.  The  culverts  can  be  circular  pipes,  pipe  arches,  or  box 
culverts.  Corrugated  metal  and  concrete  materials  are  supported,  as  well  as  many 
different  types  of  entrance  conditions. 


6.1  Flow  Types 

The  uses  (Bodhaine,  1 982)  defines  six  different  types  of  culvert  flow,  they  are: 

1)  Critical  depth  at  inlet,  unsubmerged  inlet  control. 

2)  Critical  depth  at  outlet. 

3)  Tranquil  flow  throughout. 

4)  Submerged  outlet,  pressure  flow. 

5)  Rapid  flow  at  inlet. 

6)  Full  flow  through  barrel  with  free  overfall  at  outlet. 

For  types  1 , 2,  5,  and  6,  the  discharge  through  the  culvert  is  independent  of  the 
tailwater.  These  flow  types  define  the  free  flow  rating  curve.  The  stability  of  type  6  flow 
depends  on  the  length  and  roughness  of  the  culvert  barrel.  For  most  situations,  type  6 
flow  is  highly  unstable,  oscillating  between  types  5  and  6.  The  discharge  for  types  3 
and  4  depend  on  the  tailwater  elevation,  hence  defining  the  submerged  flow  rating 
curves.  In  addition  to  flow  through  the  culvert,  the  roadway  embankment  may  be 
overtopped,  which  adds  a  weir  flow  component. 
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I 


Region  3  -  ZHW>ZW 


Legend 

ZHW  =  Headwater  elevation. 

ZTW  =  Tailwater  elevation. 

ZW  =  Weir  elevation. 

ZTC  =  Elevotion  of  D/S  culvert  crest. 


Figure  6-1  The  three  culvert  flow  regions. 


6.2  Three  Flow  Regions 

For  submerged  flow,  three  regions  can  be  defined  (Figure  6-1).  The  first  extends 
from  the  culvert  invert  to  the  crest  elevation  of  the  downstream  culvert  exit.  In  this 
region,  the  flow  through  the  culvert  is  tranquil  open  channel  flow.  The  second  region 
extends  from  the  crest  elevation  of  the  culvert  to  the  minimum  weir  elevation  of  the 
roadway  embankment.  In  this  region,  the  flow  through  the  culvert  is  pressure  flow. 
There  is  no  weir  flow.  The  third  and  final  region  extends  from  the  minimum  weir 
elevation  upwards.  In  this  region,  the  flow  through  the  culvert  is  pressure  flow  and  the 
flow  over  the  weir  may  be  submerged  by  the  tailwater. 


6.3  Culvert  Discharge  using  the  FHWA  Procedure 

There  are  two  widely  used  procedures  for  computing  culvert  discharge:  The 
USGS  procedure  (Bodhaine,  1982)  and  the  Federal  Highway  Administration  procedure 
(FHWA,  1978).  The  fundamental  research  for  both  procedures  was  conducted  by  the 
National  Bureau  of  Standards  in  the  1950's  (see  FHWA,  1986  for  a  complete  list  of 
references).  The  USGS  procedure  establishes  head  loss  parameters  and,  in  some 
cases,  the  type  of  flow  from  a  set  of  charts  and  graphs.  The  FHWA  procedure 
tabulates  head  loss  parameters  for  the  various  culvert  types  and  geometry  (see  the 
table  of  culvert  loss  coefficients  in  Appendix  B).  Because  tables  are  much  more 
convenient  than  charts,  the  FHWA  procedure  was  chosen  for  use  in  UNET. 
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Type  1  Flow.  Inlet  Control 

For  Type  1  flow,  critical  depth  occurs  at  the  inlet.  The  slope  of  the  culvert  barrel 
is  greater  than  a  critical  slope  and  the  tailwater  elevation  is  below  the  critical  elevation 
at  the  outlet.  The  inlet  is  assumed  unsubmerged  if: 


Q 


<  4 


(6-1) 


where:  Q  =  culvert  discharge, 

A  =  area  of  the  barrel  flowing  full, 
D  =  culvert  diameter. 

Equation  6-1  can  be  approximated  by: 


D 


< 


1.3 


(6-2) 


in  which  is  the  headwater  depth  above  the  upstream  culvert  invert.  Equation  6-2  is 
computationally  more  convenient  than  equation  6-1. 

The  FHWA  proposes  two  equations  for  inlet  control: 


D 


D 


+  K 


Q 


D 


0.5 


M 


-  cs 


(6-3) 
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K 


Q 


\M 


^£>0.5 


(6-4) 


where:  He  = 

K,M,  and  C  = 
S 


critical  depth  at  the  inlet, 

coefficients, 

barrel  slope. 


The  coefficients  are  identified  by  the  program,  given  the  appropriate  culvert  type,  exit, 
and  entrance  conditions. 


Type  2  Flow.  Critical  Depth  at  the  Outlet 

For  Type  2  flow,  critical  depth  occurs  at  the  culvert  outlet.  The  culvert  slope  is 
less  than  the  critical  slope  and  the  headwater-diameter  ratio.  Equation  6-2  is  less  than 
1 .3.  Tranquil  flow  extends  upstream  from  the  outlet.  The  water  surface  in  the  barrel  is 
determined  by  solving  the  energy  equation  upstream  from  the  outlet  using  the  direct- 
step  procedure  at  increments  of  0.01  foot.  The  entrance  loss  is  given  by: 
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h 


LE 


(6-5) 


in  which  is  the  entrance  loss  coefficient  given  in  Appendix  B,  under  the  section  on 
culverts. 


Type  3  Flow.  Tranquil  Flow  Throughout 

For  Type  3  flow,  the  flow  is  tranquil  throughout  and  the  tailwater  elevation 
controls  the  discharge.  The  headwater-diameter  ratio  is  less  than  1 .3.  The  FHWA 
assumes  that  the  exit  loss  at  the  outlet  is  equal  to  the  full  velocity  head: 


hio  -  2g  (®"®) 

in  which  Kq  =  1.  From  the  outlet,  the  water  surface  inside  the  conduit  is  determined  by 
a  direct  solution  of  the  energy  equation  at  an  interval  of  0.01  foot.  The  entrance  loss  is 
given  by  Equation  6-5. 

Type  4  Flow.  Pressure  Flow 

For  Type  4  flow,  the  tailwater  elevation  is  above  the  elevation  of  the  top  of  the 
culvert  outlet.  The  full  cross  section  of  the  barrel  at  the  outlet  is  submerged  and  the 
headwater-depth  ratio  is  greater  than  1 .3.  The  discharge  is  given  by  a  submerged 
orifice  equation 


Q  -  A 


^1  +  + 


29.1  n^L 


r4,3 


0.5 


(6-7) 


where: 


=  headwater  elevation, 
=  tailwater  elevation, 

=  Manning's  n  value, 

=  barrel  length, 

=  hydraulic  radius. 


Type  5  Flow.  Submerged  Flow  at  Inlet 

For  Type  5  flow,  the  headwater-depth  ratio  is  greater  than  1 .3  and  a  portion  of 
the  culvert  barrel  at  the  outlet  is  exposed.  The  FHWA  proposes  the  following  equation: 
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D 


Y  -  CS 


where  c,  Y,  and  C  are  coefficients. 


(6-8) 


Type  6  Flow.  Full  Fiow  through  barrel  with  Free  Overfali 

For  Type  6  flow,  the  headwater-depth  ratio  is  greater  than  1.3  and  the  tailwater  is 
below  the  eievation  of  critical  depth  at  the  outlet.  The  major  problem  computing  Type  6 
flow  is  estimating  the  energy  grade  line  at  the  outlet,  which  exceeds  the  top  of  the  pipe. 
The  FHWA  assumes  that  the  energy  grade  line  at  the  outlet  is  given  by  the  following 
simpie  relation: 


EGL^  =  0.5  {H^  ^  D)=Zo 


(6-9) 


where:  EGLq 

Hco 

D 

Zo 


=  energy  grade  line  at  the  outlet, 
=  critical  depth  at  the  outlet, 

=  pipe  diameter, 

=  invert  elevation  at  the  outlet. 


The  headwater  elevation  is  obtained  from  the  energy  equation  assuming  the  full 
flow  friction  losses  and  the  entrance  loss  from  Equation  6-5.  Type  5  and  Type  6  flows 
are  computed  concurrently.  If  the  Type  6  flow  is  less  than  the  Type  5  flow,  then  the 
flow  is  assumed  to  be  Type  6. 


Weir  and  Culvert  Flow 


If  the  headwater  elevation  exceeds  the  top  of  the  roadway  then  the  culvert 
discharge  is  supplemented  by  a  discharge  over  the  weir.  The  weir  discharge  is 
computed  from  the  weir  equation.  Equation  4-1 8. 


6.4  Verification  of  Culvert  Algorithm 

The  UNET  culvert  algorithm  exactly  reproduced  (within  the  limits  of  reading  the 
FHWA  charts)  the  flow  computed  from  the  FHWA  nomographs  (1985)  for  flow  types  1 , 
4,  and  5.  For  flow  types  2,  3,  5,  and  6  the  algorithm  was  verified  against  the  USGS 
example  problems  and  the  South  Florida  Water  Management  District's  program  (1985). 
The  computed  flow  values  are  shown  in  Tables  6-1  and  6-2.  The  agreement  is  within 
5%,  depending  on  loss  parameters,  for  the  majority  of  tests.  The  SFWMD  program 
identified  Test  3  as  USGS  Type  1  flow,  rather  than  Type  2  flow,  as  was  identified  by  the 
USGS  algorithm  and  UNET.  For  Test  8,  the  results  from  the  three  programs  were 
widely  different.  UNET  and  SWFMD  identified  the  flow  as  Type  5  and  the  USGS 
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algorithm  identified  the  flow  as  Type  6.  The  range  of  the  computed  flow  is  also 
puzzling,  SFWMD  being  30%  lower  than  the  UNET  value  and  the  USGS  being  30% 
higher.  Because  Type  6  flow  (where  the  discharge  is  controlled  by  the  culvert  barrel)  is 
a  rare  occurrence  and,  when  it  does  occur,  rather  short  lived,  this  ambiguity  is  not 
considered  to  be  a  limitation  of  the  program.  Rather,  the  problem  is  a  topic  for  further 
research  and  study. 


6.5  Strategy  for  Computing  Free  and  Submerged  Flow  Rating  Curves 

Free  and  submerged  rating  curves  are  computed  for  the  culvert-weir  system  for 
a  range  of  headwater  and  tailwater  elevations  entered  by  the  user.  The  free  flow  rating 
curve  is  computed  first,  assuming  a  tailwater  elevation  below  the  downstream  invert  of 
the  culvert.  Then,  for  an  array  of  tailwater  elevations,  uniformly  distributed  over  the 
entered  tailwater  range,  a  submerged  rating  curve  is  computed.  The  headwater 
elevations  are  chosen  such  that  they  lie  in  the  feasible  range  indicated  by  the  three  flow 
regions  (see  Section  6.2).  For  each  computed  flow,  the  free  flow  rating  is  checked.  If 
the  elevation-flow  point  lies  along  the  free  flow  rating,  the  point  is  discarded,  because 
the  flow  is  not  submerged.  Finally,  if  the  user  elects  to  use  the  exponential  equations, 
three  exponential  equations  (equation  4-61),  which  correspond  to  the  three  flow 
regions,  are  derived  from  the  submerged  flow  rating  curves,  using  least  squares. 


6.6  Addition  of  Risers,  Bleeders,  and  Drop  Inlets 

The  basic  culvert  can  be  modified  by  the  addition  of  a  riser,  a  bleeder,  or  a  drop 
inlet  upstream  of  the  culvert  intake. 

6.6.1  Riser 

A  riser  is  a  vertical  pipe  which  does  not  allow  flow  into  the  culvert  until  the  water 
surface  elevation  reaches  the  crest  of  the  riser  pipe.  A  typical  riser  is  shown  in 
Figure  6-2.  The  length  of  the  weir  crest  is  not  necessarily  the  circumference  of  the  riser 
pipe.  Often  the  top  of  the  riser  is  restricted  and  the  flow  is  limited  to  a  portion  of  the 
circumference.  The  riser  crest  is  modeled  as  a  free  flowing  weir  (note  that  the 
submergence  from  the  riser  barrel  is  ignored).  The  capacity  of  the  riser-culvert 
combination  is  the  lessor  of  the  flow  over  the  riser  crest  or  the  flow  through  the  culvert. 
The  riser  is  added  by  placing  a  Rl  record  (see  Appendix  B)  upstream  of  the  culvert 
record. 
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Figure  6-2  Riser  pipe  and  culvert  through  an  embankment.  The  riser 
pipe  has  a  semi-circular  overflow  section  and  a  bleeder  on 
the  upstream  face. 

6.6.2  Bleeders 

A  bleeder  is  a  geometric  opening  in  a  riser  pipe  and  in  a  weir  which  controls  the 
upstream  stage.  Five  types  of  bleeders  can  be  included: 

1)  Triangular  notch. 

2)  Rectangular  notch. 

3)  Triangle. 

4)  Rectangle. 

5)  Circle. 

The  geometry  of  each  type  is  shown  in  Figure  6-3.  The  bleeder  is  modeled  by  a 
weir  equation  which  includes  submergence.  The  bleeder  is  selected  by  adding  a  BD 
record  before  the  culvert  or  riser.  Note:  only  one  bleeder  can  be  added  for  each 
culvert. 
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Triangular  Nalch 


Rectongular  Notch 


o 

Circle 


□ 

Rectangle 


V 

Triangle 

Figure  6-3  Five  types  of  bleeders  in  the  UNET  program. 

6.6.3  Drop  Inlet  Sump 

An  inlet  sump  is  a  vertical  drop  which  occurs  before  the  culvert.  A  typical  inlet 
sump  is  shown  in  Figure  6-4.  The  drop  is  modeled  by  a  free  flow  weir  equation.  The 
capacity  of  the  culvert  is  the  lessor  of  the  culvert  flow  or  the  flow  over  the  drop  inlet  for 
the  given  headwater  and  tailwater  elevations.  The  sump  is  specified  by  including  a  Dl 
record  before  the  culvert.  The  width  of  the  inlet  sump  is  the  sum  of  the  widths  of  the 
crest  of  the  drop  before  all  the  culverts.  An  inlet  sump  cannot  be  used  with  either  a 
riser  or  a  bleeder. 


Figure  6-4  Culvert  with  upstream  inlet  sump. 
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Chapter? 

Modeling  of  Closed  Conduits 


7.1  Preissmann  Slot 


Closed  conduits  are  assumed  to  experience  flow  under  two  different  regimes:  1) 
open  channel  flow  when  the  water  surface  is  below  the  top  of  the  conduit  and  2) 
pressure  flow  when  the  pressure  head  exceeds  the  top  of  the  conduit.  Pressure  flow  is 
analyzed  using  waterhammer  equations,  which  are  presented  below  in  tensor  notation 
for  a  circular  pipe  (Streeter  and  Wylie,  1967): 


Momentum  - 

Continuity  - 

9H,  *  v,  *  nvj  *  ^l/| 

H,  *  V(H,)  =  . 

where:  V  = 

velocity. 

H  = 

piezometric  head. 

a  = 

wave  celerity, 

f  = 

Darcy-Weisbach  friction  factor. 

D  = 

diameter. 

t 

time  (independent  variable), 

X  = 

distance  (independent  variable). 

(7-1) 


(7-2) 


These  hyperbolic  partial  differential  equations  describe  the  translation  of 
pressure  waves  through  an  elastic  medium.  Impulses  travel  at  a  rate  given  by  the 
characteristic  directions: 


dx 

dt 


=  V±a 


(7-3) 


Because  the  wave  celerity  a  is  on  the  order  of  1000  times  larger  than  the  water  velocity, 
V,  the  advective  terms  in  equations  7-1  and  7-2  are  often  dropped  and  the 
characteristic  directions  become  (Streeter  and  Wylie,  1967): 


(7-4) 
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For  pressure  flow,  the  celerity  is  that  of  an  acoustic  wave  (sound  wave)  with  a 
correction  for  the  elasticity  of  the  conduit  material  (Parmakian,  1963): 


a 


K 


Dc^ 

~Ee 


-  0.5 


(7-5) 


where:  y 
K 
D 
e 

Cl 

E 


specific  weight  of  water, 
bulk  modulus  of  elasticity  of  water, 
conduit  diameter, 
conduit  thickness, 

conduit  support  parameter,  typically  0.91  for  conduits  anchored  at  both 
ends. 

Young's  modulus  of  elasticity. 


If  the  conduit  is  buried  or  bored  through  rock,  e  is  large  and  the  elasticity  correction 
becomes  insignificant,  hence: 


a 


/  lA  0.5 

V  y; 


(7-6) 


If  the  bulk  modulus  is  43.2  x  10®  lbs/ft^  then  the  celerity  is  4721  ft/s. 

The  shallow  water  equations,  equations  A-1  and  A-17,  can  be  rewritten  using 
velocity  V  and  depth  h  as  the  dependent  variables. 


Momentum  - 


V,  *  HV'J  +  g(h,)  *  g{S„  -  S,)  =  0 

(7-7) 

Continuity  - 

TM  "  +  W/,  -  A{v;)  =  0 

(7-8) 

where:  A 

=  the  cross-sectional  area. 

(AJ, 

=  the  spatial  derivative  of  area  at  constant  depth  (Liggett,  1 975), 

T. 

=  top  width. 

Like  the  waterhammer  equations,  these  equations  are  hyperbolic  partial  differential 
equations  in  the  independent  variables  x  and  f  for  which  impulses  travel  at  a  rate  given 
by  the  characteristic  directions: 


dx  ,, 

—  =  V  ±  c 
dt 


(7-9) 
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in  Which  c  is  the  celerity  of  a  gravity  wave.  The  celerity  of  a  gravity  wave  is: 


c  = 


(7-10) 


where: 


c  = 

9 

D=A/T,..  = 


the  celerity, 

the  acceleration  of  gravity, 
the  hydraulic  depth, 
the  flow  area, 
the  top  width. 


Equations  7-6  and  7-1 0  are  identical  with  the  exception  of  the  values  of  the  wave 
celerities.  Recognizing  this  fact,  Preissmann  (Cunge  et  al.,  1980)  suggested  that 
pressure  waves  can  be  approximated  by  the  shallow  water  equations  if  the  celerity  c  is 
set  equal  to  the  acoustic  celerity.  Preissmann  proposed  the  insertion  of  a  slot  of 

infinite  height  above  the  top  of  the  conduit  (see  Figure  7-1 )  The 
width  of  the  slot  is  determined  by  equating  7-6  and  7-10  and  solving  for  the  top  width- 


T  ^  ^ 
K 


(7-11) 


in  which  A  is  the  full  flow  area. 

Thus,  the  celerity  of  a  gravity 
wave,  when  the  water  surface  is  in 
the  slot,  is  equivalent  to  that  of  an 
acoustic  wave.  The  procedure  has 
utility  because  both  open  channel 
flow  and  pressure  flow  can  be 
simulated  by  solving  the  same 
equations.  The  penalty  in  accuracy 
is  a  very  slight  attenuation  due  to 
the  increase  in  area  associated  with 
the  slot.  However,  because  the 
total  slot  area  at  a  head  of  200  ft.  is 
2.98  X  10’'’  X  A,  the  increase  in 
storage  is  negligible. 

In  the  UNET  program  the 
Preissmann  slot  can  be  used  with 
circular  and  rectangular  conduits. 
The  conduit  is  specified  by 
replacing  the  GR  data  which  define 
the  cross  section  with  TN  data  for 
circular  conduits  or  a  TB  data  for 
defining  a  rectangular  conduit. 
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7.2  Darcy-Weisbach  Friction.  Factor 

The  general  equation  for  estimating  head  losses  through  conduits  and  open 
channels  of  any  section  is  (French,  1 985); 


R2g 


(7-12) 


where:  f 
L 
R 
V 


Darcy-Weisbach  friction  factor, 
conduit  length, 
hydraulic  radius, 
average  velocity. 


If  the  section  is  circular  and  the  pipe  is  flowing  full,  it  can  be  shown  that  R  =  D/4,  and 
the  conventional  form  of  the  equation  is  obtained. 

Equation  7-12  describes  the  loss  of  energy  over  a  length  of  pipe,  but,  the 
momentum  equation  includes  the  friction  slope  at  a  point.  If  equation  7-12  was  written 
over  an  infinitesimal  distance  dx,  then  the  friction  slope  would  be  S /  =  h  l/cIx or: 


S, 


R2g 


(7-13) 


The  factor  f  is  a  function  of  the  relative  roughness  and  the  Reynolds  Number.  For 
circular  sections,  relative  roughness  is  defined  as  the  ratio  of  the  roughness  height,  e, 
to  the  diameter  of  the  pipe,  e/D.  For  non-circular  sections,  D  =  4R  and  we  assume  that 
relative  roughness  is  e/(4R).  Values  of  fare  displayed  on  the  Moody  Diagram  which 
can  be  found  in  any  fluid  mechanics  text.  If  the  flow  can  be  assumed  to  be  completely 
turbulent  however,  which  is  a  good  assumption  for  most  situations  of  engineering 
interest,  then  the  friction  factor  is  only  a  function  of  relative  roughness,  simplifying  the 
problem.  The  values  of  f  versus  relative  roughness  for  turbulent  flow  are  tabulated  in 
Table  7-1 .  The  roughness  factors  for  common  materials  are  shown  in  Figure  7-2. 
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Relative  roughness  versus 

Darcy-Weisbach  friction  factor  f  for  fully  turbulent  flow. 
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Figure  7-2  R|^ative  roughness  factors  for  pipes  made  of  common  materials  (Moody7 


7.3  Pilot  Channel  For  Circular  Conduits 

flow  depths  the  Width-depth  ratio  of  a  circular  conduit  under  open  channel 

flow  IS  large.  Since  the  first  derivative  of  area  with  elevation  is  the  top  width  in  the 
Ifrnf  simulation  a  small  negative  change  in  flow  may  produce  an  unreasonable 
arge  change  in  depth  which  may  drop  below  the  invert  of  the  conduit.  That  negative 
depth  would  result  in  a  computational  error  which  will  cause  the  simulation  to  abort. 
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One  way  to  limit  the  occurrence  of  this  problem  is  to  keep  the  computation 
interval  small.  Unfortunately,  the  small  time  step  also  lengthens  the  simulation. 

Another,  more  practical  way,  is  to  define  a  pilot  channel  at  the  invert  of  the 
conduit.  The  pilot  channel  is  rectangular  in  shape.  The  area  of  the  pilot  channel  is 
borrowed  from  the  sides  of  the  conduit  producing  a  computationally  more  expedient 
shape  (see  Figure  7-3).  The  elevation-area  function  is  modified  only  at  the  lower 
stages  and  not  at  the  higher  stages.  Thus,  for  low  flows,  the  computed  stages  would 
be  lower  and  for  higher  flows,  the  computed  flows  would  be  unchanged. 
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Figure  7-3  Circular  conduit  and  pilot  channel. 


7.4  Test  of  Tunnel  Algorithm 

The  tunnel  algorithm  must  compute  the  celerity  of  a  gravity  wave  during  open 
channel  flow  and  the  celerity  of  an  acoustic  wave  during  pressure  flow.  To  demonstrate 
the  algorithm  a  partial  gate  closure  was  simulated. 


The  system  for  the  gate  closure  test  is  shown  in  Figure  7-4.  A  very  large 
reservoir  is  located  at  the  downstream  end  of  a  horizontal  conduit  33  ft  in  diameter. 
Located  1 00,000  ft  downstream  of  the  reservoir  is  a  gate.  Initially,  the  gate  is  set  such 
that  a  steady  state  discharge  of  4,000  ft^/s  is  established  in  the  system.  At  180 
seconds  into  the  simulation,  the  gate  is  partially  closed  reducing  the  discharge  from 
4,000  to  3,000  ft^/s  in  2.5  seconds.  The  sudden  gate  closure  sets  up  a  waterhammer 
problem,  where  a  pressure  wave  is  reflected  upstream  from  the  gate.  Figure  7-5  shows 
the  pressure  fluctuations  at  the  gate  and  at  the  midpoint  of  the  conduit.  Parmakian 
(1963)  derived  the  following  equation  for  the  initial  change  in  head  at  a  gate; 


AH  =  --  AV 
9 


(7-14) 
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in  which  AH  and  AV  are  the  changes  in  head  and  velocity,  respectively.  For  our 
problem,  the  change  in  head  computed  from  this  formula  is  169.1  ft.  The  tunnel 
algorithm  computed  a  maximum  change  in  head  of  169.3  ft  which  is  considered  to  be  in 
excellent  agreement.  Graphical  waterhammer  analysis  (Parmakian,  1963)  assumes 
that  the  pressure  water  travels  at  the  rate  of: 


dt 


=  a 


(7-15) 


The  midpoint  is  located  50,000  ft  from  the  gate;  assuming  that  the  celerity  of  an 
acoustic  wave  is  4660  ft/s,  the  travel  time  is  10.7  seconds.  Figure  7-5  shows  a  travel 
time  of  approximately  1 0  seconds.  Finally,  note  that  the  reflected  pressure  wave  crest 
returns  to  the  gate  in  about  40  seconds  at  the  negative  of  the  initial  value.  The 
reflected  wave  is  attenuated  by  the  friction  of  the  conduit. 
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Figure  /-s  Pressure  hydrographs  at  the  gate  and  at  the  mid-point  of  the  tunnel 
tor  the  waterhammer  problem  shown  in  Figure  7-4. 
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8.1  Storage  Areas 

A  storage  area  is  a  lake-like  region  that  can  either  provide  water  to,  or  divert 
water  from  a  channel.  Storage  areas  may  be  located  at  the  termination  of  a  stream 
reach  or  be  connected  to  a  channel  reach  by  a  lateral  spillway.  Figure  8-1  shows  an 
example  storage  area.  Reach  1  terminates  at  the  storage  area.  Reach  3  discharges 
into  the  storage  area  over  a  lateral  spillway,  which  contains  a  gated  section  and  two 
uncontrolled  weir  sections. 


UNET  assumes  that  storage  areas  have  the  following  two  properties:  1)  the 
water  surface  is  horizontal,  and  2)  a  linear  storage-elevation  relationship  exists  and  is 
defined  by: 


S-{Z,-  ZJ  A, 

where: 

S 

Storage, 

Za  = 

water  surface  elevation. 

Zao  = 

average  elevation  of  the  interior  ground  surface 

Aa  = 

surface  area. 
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The  continuity  equation  for  the  interior  is: 


n 


E  Q/ 


(8-2) 


Substituting  this  into  equation  8-1  yields: 


dt 


1  " 

=  —  T  Q. 
A,  ^  ' 


/=1 


(8-3) 


where:  n  =  the  number  of  flow  inputs, 

Qi  =  the  flow  values. 

Using  the  implicit  finite  difference  scheme,  equation  8-3  can  be  approximated  as: 


At 


1  " 


/=1 


0AQ,.) 


(8-4) 


If  Q|  is  from  a  connecting  reach,  then  Q|  =  Qj  where  j  is  the  downstream  node  of 
the  reach.  If  Qj  is  from  a  lateral  spillway,  then  Q  =  Q^  +  Q^  the  sum  of  the  spillway  and 
weir  flows.  For  the  latter  case  Q|  =  f(H)  where,  H,  the  head  across  the  weir,  is  a 
function  of  the  water  surface  at  the  spillway  and  Zg. 

The  discharge  terms  in  equation  8-4  can  be  nonlinear  if  the  flow  comes  from  a 
lateral  spillway.  It  is  assumed  that  the  nonlinearity  can  be  approximated  by  the  first 
order  Taylor  approximation.  Hence,  the  following  linear  equation  is  formed: 


N 

E  ~  ~  SABj  (8-5) 

y=i 


where: 

SA;  = 

coefficient  at  column  I, 

SA,  = 

A^/At, 

N 

number  of  nodes. 

I 

row  number  of  the  storage  equation. 

Equation  8-5  assumes  that  the  storage  equations  will  be  located  in  the 
coefficient  matrix  after  the  routing  equations,  hence,  I  >  2N. 
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Using  the  equations  presented  in  section  4.2.5,  equation  8-3  can  be  rearranged 
to  obtain: 


1  + 

B.  * 


(8-6) 


Equation  8-6  is  then  inserted  into  the  linearized,  finite  difference  form  of  the 
continuity  equation: 


CQIjAQj  +  CZmZj  +  CQZjAQj^^ 


-  CZ2.AZj^, 


=  CB, 


(8-7) 


and  into  equation  8-5.  The  coefficients  of  the  continuity  equation  are  modified  by: 

CZ1j  =  CZ  +  — 

'  '  Ax,  dZj 


(8-8) 


CZ1j^,  -  CZj^,  . 


0  dD, 


(8-9) 


CBj  =  CBj  - 


dD. 

D"  +  6 — fiAB 
dB^  ‘ 


0 


Ax„ 


(8-10) 


in  which  Ax^  is  the  equivalent  flow  distance.  The  coefficients  in  equation  8-5  are 
augmented  by: 


3^1 


(8-11) 


^^1,2/  “  ® 


dD, 

dZ 


(8-12) 


SABf  =  SABf  + 


dPu 
on  +  0 - 

dB,  * 


(8-13) 
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8.2  Connections  to  the  Downstream  Terminus  of  a  Reach 

For  connections  to  downstream  reach  terminations  where  the  downstream  node 
number  is  j,  SAj  =  1 ,  and  the  downstream  boundary  equation  becomes: 


CQIjAQj 


CZIjAZj 


CQIjAQj^, 


CZI.AZj^, 


CZAjAZ,  = 


CB: 


(8-14) 


where:  CZIj  =  1, 

CZAj  =  -1 ;  the  coefficient  for  the  stage  of  the  storage  area  at  row  2N  +  1 , 
CQIj  =  CQ2j  =  CZ2j  =  CBj  =  0. 


8.3  Submerged  Weir  Equation 


structure: 


The  energy  equation  is  written  from  headwater  to  tailwater  spanning  the  weir 


Vt 


z„  +  —  =  Zr  +  —  +  h, 

^  2g  ^  ^ 


2g 


(8-15) 


where:  =  headwater  elevation, 

Vh  =  approach  velocity  in  the  headwater, 
Zj  =  tailwater  elevation, 

Vy  =  velocity  in  the  tailwater, 

hL  =  head  loss. 


Assuming  that: 


hi 


and: 

CM 

o 

II 

(Zy  -  Z^fL^ 

where:  Q 

=  the  flow. 

L 

=  the  weir  length. 

Z^ 

=  weir  crest  elevation. 

a 

=  the  energy  loss  coefficient. 

then: 

2g 


-Zy=  (1+a) 


25f(Zy  -  Z^n^ 


(8-16) 


(8-17) 


(8-18) 
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Solving  for  Q,  and  defining  Cg  =  2g/(1+a): 


Q  =  CJ,Z,  -  Z^)L{Z^  . 


25r 


(8-19) 


8.3.1  Submergence  Coefficient 

A  simple  criteria  for  estimating  submergence  is: 


2 

i^H  -  Z^  3 


and  at  the  point  of  submergence: 


(8-20) 


(8-21) 


Moreover,  for  a  broad  crested  weir,  when  Z^^  >  and  Zj  >  Z^,  then: 

(Z„  -  =  I(z„  -  Z„)  (8-22) 

Now,  at  the  point  of  submergence,  the  equation  for  free  flow  is  equivalent  to 
equation  8-19,  therefore: 

Cs(Z„  -  zJl  =  Cs{Z„  -  Z^kzj  -  Z^)L  (8-23) 


in  which  Cq  is  the  free  flow  weir  coefficient.  Substituting  equations  8-21  and  8-22  into 
the  above  equation  and  canceling  L  yields: 


3  1 


and: 

-  Z„r  =  Cs[0.33(Z„  -  Z„)F[0.67(Z„  -  ZJ] 

3  3 

(8-24) 

Finally, 

Cb(-?h  -  =  Cs(0.38)(Z„  -  ZJ" 

(8-25) 

Cj  =  2.60Cb 

(8-26) 
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8.4  Special  Connections 

In  addition  to  lateral  spillways,  UNET  can  connect  reaches  and  storage  areas 
and  individual  storage  areas  with  families  of  rating  curves.  The  two  primary 
connections  are  culverts  and  weirs  (the  RW  record,  Appendix  B).  The  culvert 
connections  can  include  risers  and  bleeders.  The  weir  connections  can  include 
bleeders.  The  special  connections  are  directed  by  the  SC  record  which  precedes  the 
culvert  or  RW  records. 
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Chapters 

Simulation  of  Levee  Failures 


Levees  are  embankments  that  surround  an  area  of  the  floodplain  and  protect 
that  area  from  the  floodwaters  of  the  river.  The  segment  of  the  levee  that  crosses  the 
floodplain  laterally,  paralleling  a  tributary  and  connecting  to  high  ground  along  the  bluff, 
is  called  a  flank  (or  tie-back)  levee.  The  flank  levee  protects  the  interior  from 
floodwaters  from  the  tributary  and  from  backwater  from  the  main  river.  A  typical  levee 
system  consists  of  an  upstream  flank  levee,  a  frontage  levee  along  the  main  stem,  and 
downstream  flank  levee  which  form  a  “C”  shaped  embankment  that  encircles  the 
interior  area.  Figure  9-1  shows  typical  levee  systems  between  St.  Louis,  MO  and 
Chester  IL. 

During  flows  when  the  levee  embankment  is  intact  and  the  embankment  has  not 
been  overtopped,  the  levee  may  increase  stages  along  the  main  river  because  the 
overbank  conveyance  and  storage  of  the  protected  floodplain  is  not  available. 

However,  should  the  embankment  fail,  the  storage  of  the  floodplain  may  be  reclaimed. 

If  the  embankment  is  severely  eroded  by  overbank  flow,  the  conveyance  of  the 
floodplain  is  reclaimed. 

The  failure  of  a  levee  system  is  a  dynamic  event.  The  water  surface  of  the  river 
at  the  breach  is  reduced.  The  flow  from  upstream  is  accelerated  by  the  increased  slope 
of  the  water  surface.  The  flow  downstream  is  either  reduced  by  the  flow  through  the 
breach  or  the  flow  may  reverse  because  of  the  negative  flow  gradient.  Figure  9-2 
(USAGE,  1993)  shows  the  acceleration  and  deceleration  of  flow.  The  overall  effect  is  a 
reduced  water  surface  along  the  main  river  until  the  levee  storage  fills  to  equalize  water 
surface  elevations  in  both  the  river  and  the  leveed  areas.  In  1993  the  failure  of  the 
Columbia  Levee  and  the  subsequent  failures  of  the  Harrisonville,  Stringtown,  and  Ft. 
Chartes  systems  reduced  stages  along  the  Mississippi  River  by  several  feet  and 
delayed  the  flood  crest  at  Chester  by  six  days.  Figure  9-3  shows  the  maximum  water 
surface  along  the  Mississippi  River  with  the  levee  failures  and  without  the  levee  failures. 

There  are  at  least  two  geometric  possibilities  for  the  overbank  flow  areas.  If  the 
flow  capacity  of  the  breaches  are  small  with  respect  to  the  total  storage  within  the  levee 
system,  the  levee  will  act  similar  to  a  lake  with  multiple  connections  to  the  river  network. 
The  water  surface  inside  the  levee  will  be  nearly  horizontal.  With  this  scenario  the 
levee  embankments  are  still  intact  and  there  is  no  significant  flow  over  the  floodplain. 
During  the  1973  and  1993  Mississippi  River  floods  and  the  1986  Missouri  River  flood, 
the  levees  were  intact  and  the  overbank  areas  functioning  as  interconnected  lakes. 

In  the  second  scenario,  the  embankments  are  severely  eroded  and  the  total 
breach  capacity  is  large  compared  to  the  storage.  The  floodplain  is  carrying  a  larger 
portion  of  the  flow  and  the  water  surface  in  the  overbank  has  a  slope.  During  the  third 
crest  of  the  1993  flood  along  the  Missouri  River,  the  embankments  were  severely 
eroded  and  the  Missouri  River  was  actively  conveying  flow  over  the  floodplain;  as  if  the 
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Figure  9-1  Typical  levee  systems  between  St.  Louis  and  Chester  along  the 


Mississippi  River.  The  levee  systems  constrict  the  flow  to  main  channel 


and  a  small  portion  of  the  floodplain,  protecting  the  agricultural  land  within 
the  systems. 


levees  had  not  existed.  This  condition  cannot  be  modeled  by  the  network  of  cells  and 
must  be  modeled  instead  as  open  channel  flow  routing. 
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Figure  9-2  Illustrates  the  water  surface  being  depressed  by  a  levee  breach.  Water 
from  upstream  is  accelerated  toward  the  breach  by  the  increased  water 
surface  slope.  Downstream,  where  the  slope  is  reduced,  the  flow  is 
decreased  of  the  flow  may  reverse  and  move  toward  the  breach. 


Figure  9-3  Maximum  water  surface  elevation  along  the  Mississippi  River  during  the 
1 993  flood  with  (dashed  line)  and  without  (solid  line)  levees. 
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9.1  Modeling  Approaches 

In  the  foregoing  paragraphs  a  levee  system  was  described  as  functioning  either 
as  a  series  of  cascading  lakes  or  as  a  parallel  channel  where  the  embankments  are 
eroded  to  a  point  where  they  no  longer  control  the  flow.  For  the  latter  condition,  the 
areas  behind  the  levees  can  function  as  a  series  of  interconnected  lakes  before  the 
embankments  are  severely  eroded.  Thus,  the  model  must  be  able  to  simulate  both  the 
system  of  interconnected  lakes  and  a  parallel  channel.  The  following  paragraphs 
recommend  an  approach  to  modeling  these  two  types  of  systems. 

When  the  embankments  still  control  the  flow  to  and  from  the  levee  storage,  the 
levees  can  be  modeled  as  a  network  of  storage  cells.  The  modeler  must  assume  that 
the  water  surface  is  horizontal  within  each  of  the  cells.  The  cell  connections  such  as 
culverts,  weirs,  and  riser  pipes.  Figure  9-1  shows  the  levees  between  St.  Louis  and 
Chester  and  Figure  9-4  shows  the  cell  layout  that  was  used  to  model  this  system.  Each 
levee  cell  is  assigned  a  number.  To  distinguish  the  cell  numbers,  the  numbers  are 
negative.  Each  levee  has  an  upstream  and  a  downstream  breach  that  connects  the 
levee  cell  to  the  river.  The  Columbia  and  Harrisonville  systems  are  connected  by  a 
breach  between  the  flank  levees.  Likewise,  there  is  a  potential  connection  between  the 
Ft.  Chartres  and  the  Prairie  Du  Rocher  Levee  Systems.  Figure  9-5  compares  the 
observed  stage  hydrograph  with  the  computed  stage  hydrograph  at  St.  Louis. 

Figure  9-6  compares  the  computed  and  observed  stage  hydrographs  at  Chester.  The 
cell  model  adequately  reproduces  the  reduction  in  stage  at  St.  Louis  and  Chester.  To 
further  reinforce  this  point.  Figure  9-5  also  shows  the  computed  stage  hydrograph  that 
would  have  occurred  if  the  levees  had  not  failed.  The  stages  would  have  been  one  foot 
higher  at  St.  Louis  and  two  feet  higher  at  Chester.  Note  the  crest  at  Chester  is  delayed 
by  about  6  days  by  the  levee  failure.  Normally,  the  routing  time  between  St.  Louis  and 
Chester  is  about  one  day.  The  longer  lag  time  is  the  result  of  flood  water  routed 
through  the  levee  system.  The  model  adequately  reproduces  the  shape  and  lag  of  the 
hydrograph  being  routed  through  the  cells. 

The  connecting  overbank  channel  concept  attempts  to  simulate  the  levee  system 
both  as  a  cell  and  as  a  parallel  channel.  That  component  must  simulate  both  cell  and 
river  attributes.  Figure  9-7  shows  the  cell  parallel  channel  levee  model  representation 
of  the  Harrisonville,  Stringtown,  and  Ft.  Chartres  levee  system.  The  fundamental 
component  is  a  channel  which  is  connected  on  the  upstream  and  downstream  ends  by 
two  small  cells.  The  channel  cross  section  has  a  small  pilot  channel  as  shown  on 
Figure  9-8  The  cells  on  either  end  maintain  a  horizontal  water  surface  inside  the  cell 
while  the  levees  are  intact.  The  channel  and  cells  fill  during  levee  failure.  The  water 
surface  will  remain  nearly  horizontal  throughout  the  system  for  small  breaches.  If  the 
capacity  of  the  upstream  breach  is  greater  than  the  downstream  breach,  a  slope  will  be 
generated  in  the  downstream  direction  and  the  system  will  function  as  a  parallel 
channel. 
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Figure  9-4  The  cell  layout  used  to  model  the  Columbia,  Harrisonville, 

Stringtown,  and  Ft.  Chartres  Levee  Systems.  The  Harrisonville, 
and  Ft.  Chartres  levee  are  one  contiguous  storage  area.  The 
levee  district  are  political  entities  that  are  not  separated  by 
physical  boundaries. 
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Figure  9-6  Observed  and  computed  stage  hydrographs  at  Chester. 


Figure  9-7  The  cells  with  parallel  channel  model  for  the  Harrisonville,  Stringtown, 
and  Ft.  Chartres  levee  system. 
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Pilot  channel. 

Figure  9-8  Pilot  channel  in  the  parallel  channel. 

The  water  surface  is 

maintained  in  the  pilot  channel  by  the  storage  cells  at  the  upstream 
and  downstream  ends. 


9.2  Levee  Failures 

The  UNET  program  supports  two  procedures  for  the  simulation  of  levee  failures. 
The  simple  failure  procedure  applies  the  simple  spillway  concept  where  the  flow  is 
given  by  the  volume  of  available  storage  multiplied  by  a  linear  routing  factor. 

Knowledge  of  the  size  and  evolution  of  breaches  in  levee  systems  is  usually  limited. 
Detailed  levee  breach  information  for  events  occurring  years  ago,  such  as  the  1993 
flood  on  the  Mississippi  River,  are  not  readily  accessible.  Usually,  the  only  information 
available  is  the  names  of  the  levee  systems  that  failed.  Detailed  modeling  of 
embankment  failures  when  the  details  of  the  breach  are  unknown  is  therefore  not 
practical.  The  UNET  simple  levee  failure  algorithm  acknowledges  this  lack  of  data  and 
applies  a  simple  hydrologic  concept  that  is  similar  to  the  filling  of  a  levee  system. 
Because  the  flow  into  the  area  behind  the  levee  is  proportional  to  the  available  storage, 
the  flow  is  greatest  at  the  start  of  failure  and  decreases  as  the  levee  fills.  The 
procedure  also  has  a  computational  advantage  in  that  it  is  stable  and  will  function  with 
larger  time  steps.  The  simple  failure  connection  is  entered  by  an  SF  record. 

The  second  failure  procedure  is  a  detailed  simulation  of  a  failure  in  the  levee 
embankment.  This  procedure  simulates  an  enlarging  breach  which  corresponds  to 
either  a  piping  or  an  embankment  failure.  The  breach  starts  when  a  failure  elevation  is 
exceeded  and  the  breach  is  assumed  to  enlarge  at  a  linear  rate.  The  breach  can  be 
placed  between  a  river  and  a  levee  cell  and/or  between  two  levee  cells.  Flow  through  a 
piping  breach  is  given  by  an  orifice  equation.  When  the  pipe  breaks  through  the  top  of 
a  levee,  the  flow  is  given  by  a  weir  equation.  The  flow  through  an  overtopping  breach  is 
also  described  by  a  weir  equation.  The  embankment  failure  is  entered  with  an  EF 
record. 

A  detailed  discussion  of  the  simple  failure  and  the  embankment  failure 
procedures  is  given  in  section  9.5. 
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9.3  Include  Files 

When  a  large  number  of  levee  systems  (say,  ten  or  more)  are  modeled,  the  cell 
and  levee  connection  definitions  begin  to  obscure  the  cross  section  geometry.  In  this 
case  it  is  recommended  that  the  UNET  user  define  the  cells  and  connections  in  a 
separate  file  that  is  called  an  INCLUDE  FILE.  After  the  cross  section  geometry  has 
been  entered,  the  include  files  are  specified  using  the  IS  record  and  the  data  are  read. 

The  include  file  enables  the  following  functions: 

•  Define  cells  using  the  RE,  SA,  SV  (optional),  and  HS  records. 

•  Define  simple  levee  failure  RE  and  SF  records. 

•  Define  embankment  failures  using  RE,  SC,  and  EF  records. 

•  Define  culvert  cell  connections  using  RE,  SC,  CC,  CB,  CE,  CA,WD,  and  CL 
records. 

•  Define  riser  pipe  connections  using  RE,  SC,  Rl,  WD,  and  RL  records. 

•  Define  gated  spillway  connections  using  RE,  SC,  SP,  and  WD  records. 

Two  notes  regarding  the  above  input  data  need  to  be  made.  The  RE  record 
defines  the  reach  number  and  the  cross  section  river  mile  (SECNAM  on  the  X1  record) 
that  the  cell  or  connection  is  attached  to.  An  RE  record  must  precede  every  cell 
definition  and  connection.  The  SC  (special  connection)  record  defines  the  connection 
from  reach  to  cell  and  from  cell  to  cell  for  different  types  of  flow  connections.  Refer  to 
Appendix  B  for  details. 


9.4  Output  from  Levee  Systems 

The  primary  program  outputs  that  describe  the  function  of  the  levee  cells  are  the 
flow  and  stage  hydrographs  written  to  HEC-DSS.  The  UNET  model  writes  a  stage 
hydrograph  to  HEC-DSS  for  each  cell.  For  each  flow  connection  UNET  writes  a  stage 
hydrograph  to  HEC-DSS. 


9.5  Embankment  Failure 

The  embankment  failure  algorithm  simulates  the  failure  of  a  structure  between 
storage  cells,  between  a  reach  and  a  storage  cell,  or  between  reach  cross  sections  (in¬ 
line  in  a  reach).  The  failure  algorithm  does  not  simulate  the  erosion  of  material  from  the 
breach;  rather,  the  algorithm  simulates  the  enlargement  of  breach  dimensions  to  an 
ultimate  size  during  an  assumed  time  of  failure.  Two  types  of  breaches  can  be 
simulated:  a  piping  breach  where  the  failure  results  from  seepage  through  the 
embankment,  and  an  overtopping  failure  where  the  failure  results  from  flow  over  the  top 
of  the  structure. 
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The  embankment  failure  algorithm  can  be  used  in  conjunction  with  the  following 
interior  boundary  conditions  which  simulate  the  primary  outlets  for  a  dam: 

1)  Gated  spillway, 

2)  Culverts, 

3)  Riser  pipes, 

4)  Weirs. 

An  embankment  failure  is  specified  by  an  EF  record  entered  in  the  cross  section 
data  file.  If  the  embankment  failure  is  between  cross  sections,  the  EF  record  is  placed 
immediately  after  the  SP  record  for  a  spillway,  the  culvert  data,  the  Rl  records  for  riser 
pipes,  or  the  RW  record  for  a  weir.  If  the  connection  is  between  a  reach  and  a  cell,  or 
betweeri  two  cells,  the  EF  record  must  be  preceded  by  an  SC  record  which  defines  the 
connections.  These  connections  are  illustrated  in  the  example  problem. 

9.5.1  Overtopping  Breach 

The  overtopping  breach  simulates  the  failure  of  an  embankment  after  it  has  been 
overtopped.  The  failure  begins  when  the  water  level  exceeds  a  specified  failure 
elevation  ZFAIL.  If  ZFAIL  is  higher  than  the  top  of  the  dam  and  the  water  level  exceeds 
the  crown,  weir  flow  is  calculated  over  the  embankment,  but  the  failure  of  the 
embankment  is  not  simulated.  At  the  start  of  failure,  the  initial  width  and  depth  of  the 
trapezoidal  breach  enlarges  linearly  with  time  to  a  final  width,  WBREACH,  and  a  final 
invert  elevation,  ZBRINV.  The  side  slopes  of  the  breach  are  assumed  to  be  constant. 
Figure  9-9  shows  the  enlargement  process. 
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The  flow  through  the  breach  is  computed  from  the  weir  flow  equations  which  are 
presented  in  Chapter  4.  The  flow  over  the  side  slopes  is  computed  by  applying  the 
average  head  to  the  average  crest  elevation  along  the  sloping  section. 

9.5.2  Piping  Failure 

The  piping  failure  assumes  that  a  seepage  through  the  embankment  will  enlarge 
into  a  conduit  that  will  consume  the  embankment  and  form  a  trapezoidal  breach.  The 
cross  section  of  the  pipe  is  assumed  to  be  a  hexagon.  The  piping  failure  starts  when 
the  water  exceeds  the  elevation  ZFAIL.  If  ZFAIL  is  higher  than  the  top  of  the  dam  and 
the  water  level  exceeds  the  crown  but  not  ZFAIL,  weir  flow  will  be  calculated,  but  the 
failure  will  not  commence.  At  the  start  of  failure,  the  initial  base  width  and  height  of  the 
breach  is  zero  and  the  centroid  of  the  breach  is  at  the  elevation,  ZBREACH.  The  base 
width  is  the  lower  horizontal  segment  of  the  hexagon.  During  the  assumed  time  of 
failure,  DTFAIL,  the  width  and  height  of  the  breach  enlarge  linearly  around  the  axis  of 
the  centroid  to  its  final  trapezoidal  shape.  The  side  slopes  of  the  hexagon  are  a 
constant  SS.  The  breach  becomes  a  trapezoid  when  the  top  of  the  hexagon  breaks  the 
crest  of  the  embankment.  The  side  slopes  remain  constant.  In  its  final  form,  the 
breach  is  a  trapezoid  with  an  invert  of  width  WBREACH  and  an  invert  elevation  of 
ZBRINV.  Figure  9-10  shows  the  enlarging  hexagonal  breach  and  Figure  9-1 1  shows 
the  final  trapezoidal  breach. 
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Figure  9-10  Hexagonal  piping  breach. 
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flow  is  given  by: 

O  =  Qf^A(Z„  +  — 

2g 


where:  Q  = 
C  = 

g  = 

A  = 
Zh  = 
Vh  = 
Zbreach  = 

For  submerged 


where:  = 

Zt  = 


9.6  The  Simple  Embankment  Failure 

The  simple  embankment  failure  algorithm  that  assumes  that  the  flow  into  a  cell  or 
between  two  cells  is  proportional  to  the  available  storage  to  be  filled,  hence: 


flow 

orifice  coefficient 

acceleration  of  gravity 

area  of  the  orifice 

headwater  elevation 

headwater  velocity 

elevation  of  the  centroid  of  the  pipe 


flow,  the  flow  is  given  by: 

C 


Q  = 


flc(1  -F>c) 


Zh- 


^9 


-  Z, 


1/2 


(9-2) 


critical  submergence  ratio 
tailwater  elevation 


-  Z 

^BREACH/ 


(9-1) 
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Q  =  k*  AV 


(9-3) 


where  AV  is  the  volume  to  be  filled  and  /c  is  a  linear  routing  factor  with  the  units  of  time’’ 
(hours'^).  This  concept  for  two  cells  is  illustrated  in  Figure  9-12. 

The  key  to  using  a  simple  spillway  is  the  selection  of  the  routing  constant,  k.  When 
the  cell  is  connected  to  a  river  by  a  single  breach,  the  constant  is  small,  say  0.05 
hours'^  When  the  cell  is  connected  by  multiple  breaches,  there  is  a  flow  of  water 
through  the  cell  and  the  constant  is  much  larger,  say  0.2  hours'V  When  observed  stage 
data  are  available,  the  routing  coefficients  may  be  calibrated  to  reproduce  the  observed 
stage  data. 

The  simple  embankment  failure  is  enabled  with  the  SF  record.  The  embankment 
failure  is  assumed  to  begin  when  the  water  exceeds  ZFAIL.  The  invert  of  the  breach  is 
given  by  ZBRINV.  The  linear  routing  coefficients  for  inflow  and  outflow  are  given  by 
CINLV  and  COUTLV.  To  simulate  the  enlarging  breach,  the  linear  routing  constant  is 
assumed  to  increase  from  0  to  its  full  value  over  the  time  DTFAIL.  If  the  filling  time  is 
specified,  the  levee  is  assumed  to  fill  in  the  time  DTFILL.  When  the  water  falls  below 
ZBRINV,  the  embankment  is  rebuilt. 
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The  UNET  ice  cover  option  allows  the  user  to  model  channels  with  floating, 
stationary  ice  covers.  This  option  is  appropriate  where  the  ice  cover  is  in  place  during 
the  entire  time  simulated,  and  the  ice  cover  thickness  and  the  ice  cover  roughness,  as 
defined  by  its  Manning's  n  value,  are  known  and  unchanging  with  time.  This  option 
allows  the  user  to  input  different  ice  thicknesses  in  the  channel  and  the  left  and  right 
overbanks.  It  allows  the  thickness  and  the  roughness  to  be  changed  at  every  cross 
section,  if  required. 

Based  on  the  given  ice  thicknesses  and  ice  roughness,  this  option  modifies  the 
tables  of  elevation  versus  flow  area  and  conveyance  that  are  created  by  the  program 
CSECT.  It  is  assumed  that  the  ice  cover  is  always  floating  at  hydrostatic  equilibrium. 
The  flow  areas  of  the  channel  and  the  left  and  right  overbanks  are  reduced  by  an  area 
equal  to  the  submerged  area  of  the  ice  cover.  This  submerged  area  is  assumed  to  be  a 
trapezoid  with  a  top  surface  coinciding  with  the  water  surface  elevation  and  a  bottom 
surface  at  a  depth  equal  to  the  thickness  of  the  ice  multiplied  by  the  specific  gravity  of 
the  ice.  The  user  is  allowed  to  input  a  specific  gravity  for  the  ice  and  to  vary  it  from 
cross  section  to  cross  section.  The  default  value  is  0.916.  The  conveyance  of  the 
channel  is  modified  by  accounting  for  the  change  in  area,  the  decrease  in  hydraulic 
radius,  and  the  composite  n  value.  This  option  determines  a  composite  Manning’s  n 
value  using  the  Balokon-Sabaneev  formula  (Ashton  1986)  for  the  channel  and  left  and 
right  overbanks  based  on  the  given  bed  n  value  and  the  given  ice  n  value.  The 
hydraulic  radius  is  found  by  dividing  the  flow  area  by  the  wetted  perimeter,  which 
includes  the  width  of  the  underside  of  the  ice  cover. 

The  ice  cover  is  assumed  to  occur  only  within  the  channel  and  left  and  right 
overbank  areas.  Storage  area  calculations  are  not  effected.  If  encroachments  are 
specified,  the  ice  cover  is  not  assumed  to  exist  outside  the  encroachments  at  any 
elevation.  Pilot  channel  calculations  are  not  affected  by  the  presence  of  an  ice  cover. 
The  option  also  checks  that  the  minimum  elevation  specified  for  the  tables  created  by 
CSECT  provides  sufficient  depth  for  the  ice  cover  to  float  (that  is,  the  bottom  of  the  ice 
cover  cannot  be  below  the  minimum  elevation  of  the  channel.).  If  there  is  not  sufficient 
depth,  the  minimum  elevation  is  increased  by  the  submerged  thickness  of  the  ice. 

See  Appendix  D,  example  problem  3  for  more  information  on  ice. 
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11.1  UNET  System 

The  components  of  the  UNET  system,  as  operated  on  a  DOS  platform  for 
simulations,  consist  of  five  modules  (in  addition  to  HEC-DSS).  They  are:  CSECT, 
RDSS,  UNET,  TABLE,  and  UNETMU.  A  brief  description  of  them  follows. 

Program  CSECT  performs  the  following  basic  functions: 

•  Reads  a  geometry  input  file  developed  by  the  user  and  converts  HEC-2 
style  cross  sections  into  tables  of  elevation  versus  area,  conveyance,  and 
storage; 

•  Tabulates  interior  boundary  conditions; 

•  Resolves  network  connections  between  reaches  and  storage  areas. 

The  geometry  input  file  is  denoted  by  the  extension  ".CS".  The  file  is  similar  to 
an  HEC-2  input  file  and  contains  all  physical  cross  section  information;  oriented  from 
upstream  to  downstream.  CSECT  writes  tables  of  cross  section  properties  and  reach 
connection  data  to  a  binary  file  given  the  ".TC"  extension.  This  file  is  then  read  by 
RDSS  and  UNET  during  the  unsteady  flow  simulations.  CSECT  must  be  run  prior  to 
the  first  unsteady  flow  simulation  and  subsequently  only  when  the  geometry  file  is 
modified. 

The  following  basic  cross  section  input  records  are  nearly  identical  to  HEC-2 
records:  NC,  NH,  XI,  X2,  X3,  BT,  and  GR.  Because  UNET  accounts  for  the 
conservation  of  mass,  or  volume,  throughout  a  routing  reach,  off-channel  storage  must 
be  described  in  addition  to  conveyance  on  the  GR  records.  A  thorough  re-evaluation  of 
existing  HEC-2  GR  data  is  important  when  they  are  being  used  in  UNET  or  any  other 
unsteady  flow  model.  The  X3  record  has  been  expanded  to  define  both  conveyance 
limits  and  storage  areas,  but  the  field  definitions  are  similar  to  those  in  HEC-2.  The 
principal  records  used  in  CSECT,  other  than  those  similar  to  HEC-2,  are  the  following: 

JB:  job  control, 

XK:  define  elevation  table  limits  and  distance  between  interpolated  cross 
sections, 

UB:  define  upstream  boundary  conditions  and  reach  connections, 

DB:  define  downstream  boundary  conditions  and  reach  connections, 

HY:  write  hydrographs  to  DSS  at  the  cross  section  identified  by  the  previous 
XI  record, 

SP:  define  a  gated  spillway  across  the  channel, 

LS:  define  a  gated  spillway  discharging  either  into  another  reach  or  out  of  the 

system. 
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define  a  lateral  spillway  discharging  into  a  storage  area, 
define  a  storage  area, 
culvert  records, 

define  a  weir  section(s)  associated  with  SP,  LS  and  LA  spillways;  define  a 
weir  flow  equation  for  cross-channel  drop  structures;  or  define  the 
roadway  weir  for  culverts  and  bridges. 

The  SP  through  WD  records  define  interior  boundary  conditions  and  are  position 
dependent  i.e.,  the  interior  boundary  condition  is  inserted  between  a  pair  of  X1  records 
which  bound  the  structure.  Appendix  B  describes  the  details  of  data  input  and 
Appendix  D  presents  example  problems  which  illustrate  the  use  of  several  input 
records. 

In  addition  to  the  CSECT  input  file,  a  UNET  input  file  must  be  developed  by  the 
user  prior  to  running  the  UNET  system.  This  file  is  denoted  by  the  extension  ".BC". 

The  file  contains  program  instructions  and  data  required  by  the  RDSS,  UNET  and 
TABLE  programs. 


LA; 

SA: 

CC: 

WD: 


/SOUNOAAY 
CONOmONS 
TABLES 


/HYDRAUUC 
RESULTS 
FILE 


Figure  11-1  Relationship  between  UNET  programs  and  DSS. 
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The  unsteady  flow  portion  of  the  UNET  system  consists  of  three  programs: 

RDSS:  Reads  and  reformats  the  ".BC"  input  file.  Reads  pathnames  for 

boundary  condition  data  from  the  .BC  file,  reads  the  associated 
DSS  data,  and  converts  it  into  tables.  Appends  the  tables  to  the 
reformatted  .BC  file  and  creates  a  new  file  named  "TAPES". 

TAPES  is  then  used  as  input  to  UNET. 

UNET :  The  unsteady  flow  routing  simulation  model. 

TABLE:  Writes  computed  hydrographs,  maximum  water  surface  elevation 

profiles,  and  instantaneous  profiles  of  discharge  and  stage  to  DSS. 
Creates  the  plot  macro  file  PLTCON  for  DSPLAY. 

Program  UNETMU  is  a  simple  point  and  click  interface  that  allows  the  user  to 
easily  select  which  programs  to  run  and  identify  input/output  files.  The  menu  then 
writes  a  DOS  batch  program  that  executes  the  programs. 

UNETMU  is  executed  from  a  small  batch  file  called  RUNUNET.BAT  (type 
"RUNUNET").  RUNUNET.BAT  serves  two  purposes:  (1)  it  executes  UNETMU,  then  (2) 
executes  a  second  batch  file  RUNU.BAT,  which  is  created  by  UNETMU.  UNETMU 
reads  and  writes  a  small  data  file  RUNU.DAT  which  stores  the  user's  responses  to  the 
menu  prompts.  Based  on  these  responses,  RUNU.BAT  is  written.  RUNU.BAT  controls 
the  execution  of  CSECT,  RDSS,  UNET,  TABLE  and  DSPLAY.  The  menu  program  was 
designed  so  that  the  user  must  only  interact  with  the  UNETMU  program.  Figure  11-2 
shows  the  UNETMU  screen.  Examples  of  RUNUNET.BAT,  RUNU.BAT  and 
RUNU.DAT  are  given  below. 


RUNUNET.BAT  RUNU.DAT 

©UNETMU  C: 

@IF  ERRORLEVEL  1  GOTO  :END  YES 
@RUNU  unetex1.cs 

:END  unetexl.cso 

@CLS  YES 

unetexi  .be 
unetexi  .bco 

RUNU.BAT 


C:\HECEXE\CSECT  I=unetex1.cs  0=unetex1  .cso  T=unetex1.TC 
©IF  ERRORLEVEL  1  GOTO  END 

C:\HECEXE\RDSS  I=unetex1.bc  0=unetex1.bco  B=TAPE5  T=unetex1.TC 
©IF  ERRORLEVEL  1  GOTO  END 

C:\HECEXE\UNET  l=TAPE5  0=+unetex1  .bco  T=unetex1.TC 

©IF  ERRORLEVEL  1  GOTO  END 

C:\HECEXE\TABLE  0=+unetex1  .bco  T=unetex1  .tc 

©IF  ERRORLEVEL  1  GOTO  END 

CALL  DSPM  PLTCON 

©DEL  TAPE*.* 

:END 
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RUNUNET.BAT  and  another  batch  file  DSPM.BAT,  supplied  with  the  UNET 
system  diskettes  should  reside  in  a  directory  on  the  computer's  PATH.  CSECT.EXE, 
RDSS.EXE,  UNET.EXE,  TABLE.EXE,  UNETMU.EXE  and  DSPLAY.EXE  should  all 
reside  on  the  same  drive  and  in  the  HECEXE  subdirectory.  RUNU.DAT  and  the 
DSPLAY  macro  file  PLTCON  are  written  to  the  current  directory. 


Figure  11-2  Menu  for  RUNUNET 


1 1 .2  HEC  Data  Storage  System  (HEC-DSS) 

An  important  feature  of  the  UNET  system  is  its  interconnection  to  the  DSS  data 
base  (1987,  1990b).  The  DSS  data  base  is  designed  to  store  time  series  data,  e.g., 
discharge  and  stage  hydrographs,  and  paired  function  data,  e.g.,  rating  curves, 
sediment  gradation  data,  etc.,  which  are  common  to  hydrologic  problems.  It  is  much 
more  efficient  than  conventional  relational  data  bases  for  time  series  data.  Tests  by 
Barkau  have  shown  that  DSS  file  sizes  are  1/10  to  1/4  the  size  of  relational  data  base 
files  and  that  access  times  are  about  1/10  of  the  latter. 

DSS  provides  a  convenient  link  between  a  hydrologic  model,  such  as  HEC-1 
(HEC,  1990a),  and  UNET.  Figure  11-3  depicts  this  relationship.  HEC-1  may  be  used 
to  compute  a  runoff  hydrograph  and  to  write  the  data  to  a  DSS  file,  which  can  later  be 
read  by  UNET. 

For  large  problems,  UNET  requires  vast  amounts  of  hydrologic  data  to  specify 
boundary  conditions  and  observed  hydrographs  for  calibration.  As  direct  data  entry  for 
such  problems  can  be  quite  time  consuming,  DSS  can  simplify  input  preparation 
significantly.  The  user  specifies  the  DSS  file,  the  time  interval  of  DSS  data,  the 
simulation  period  (referred  to  as  the  time  window),  and  the  DSS  pathname  for  each  set 
of  time  series  or  paired  function  data. 
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The  UNET  system  is  able  to  compute  and  write  the  following  types  of  data  to 
DSS:  (1)  discharge  and  stage  hydrographs,  (2)  maximum  water  surface  profiles,  (3) 
instantaneous  discharge  and  stage  profiles,  (4)  channel  invert  and  bank  profiles,  and 
(5)  elevation  versus  conveyance  and  area  properties.  DSPLAY  may  then  be  used  to 
plot  or  tabulate  the  computed  results  for  review  or  for  comparison  with  observed  data. 
Other  DSS  utility  programs  may  be  used  to  manipulate,  edit  or  further  analyze  the 
results.  The  user  should  refer  to  HEC  (1 990b),  for  complete  documentation  on  DSS 
and  DSPLAY.  Appendix  A  of  that  reference  describes  the  convention  for  naming  the 
six-part  DSS  pathname. 
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The  physical  laws  which  govern  the  flow  of  water  in  a  stream  are:  (1)  the 
principle  of  conservation  of  mass  (continuity),  and  (2)  the  principle  of  conservation  of 
momentum.  These  laws  are  expressed  mathematically  in  the  form  of  partial  differential 
equations,  which  will  hereafter  be  referred  to  as  the  continuity  and  momentum 
equations.  The  derivations  of  these  equations  are  presented  in  this  appendix  (Liggett 
and  Cunge,  1975). 


A.1  Continuity  Equation 

Consider  the  elementary  control  volume  shown  in  Figure  A-1 .  In  this  figure, 
distance  x  is  measured  along  the  channel,  as  shown.  At  the  midpoint  of  the  control 
volume  the  flow  and  total  flow  area  are  denoted  Q  and  Aj,  respectively.  The  total  flow 
area  is  the  sum  of  active  area  A  and  off-channel  storage  area  S. 


I 


Q{x,t)  ►  h(x.t) 

( 


Figure  A-1  Elementary  Control  Volume  for  Derivation  of  Continuity  and 
Momentum  Equations. 


Conservation  of  mass  for  a  control  volume  states  that  the  net  rate  of  flow  into  the 
volume  be  equal  to  the  rate  of  change  of  storage  inside  the  volume.  The  inflow  to  the 
control  volume  may  be  written  as: 


dx  2 


(A-1) 


and  the  outflow  as: 


Q  + 


dQ  Ax 
dx  2 


(A-2) 


Assuming  that  Ax  is  small,  the  change  in  mass  in  the  control  volume  is  equal  to: 


dA^ 

~di 


Ax  =  p 


dx  2 


dx  2 


.  Q, 


(A-3) 
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where  Q,  is  the  lateral  flow  entering  the  control  volume  and  p  is  the  fluid  density. 
Simplifying  and  dividing  through  by  pZlx  yields  the  final  form  of  the  continuity  equation: 


dAj 


dx 


q.  =  0 


(A-4) 


in  which  q,  is  the  lateral  inflow  per  unit  length. 


A.2  Momentum  Equation 


Conservation  of  momentum  is  expressed  by  Newton's  second  law  as: 

E  F  -  — 

dt 


(A-5) 


Conservation  of  momentum  for  a  control  volume  states  that  the  net  rate  of  momentum 
entering  the  volume  (momentum  flux)  plus  the  sum  of  all  external  forces  acting  on  the 
volume  be  equal  to  the  rate  of  accumulation  of  momentum.  This  is  a  vector  equation 
applied  in  the  x-direction.  The  momentum  flux  (MV)  is  the  fluid  mass  times  the  velocity 
vector  in  the  direction  of  flow.  Three  forces  will  be  considered:  (1)  pressure,  (2)  gravity 
and  (3)  boundary  drag,  or  friction  force. 

Pressure  forces  Figure  A-2  illustrates  the  general  case  of  an  irregular  cross 
section.  The  pressure  distribution  is  assumed  to  be  hydrostatic  (pressure  varies  linearly 
with  depth)  and  the  total  pressure  force  is  the  integral  of  the  pressure-area  product  over 
the  cross  section.  After  Shames  (1962),  the  pressure  force  at  any  point  may  be  written 
as: 


h 

f  pg(h-B)m)d^  (A.6) 

0 


where  h  is  the  depth,  fthe  distance  above  the  channel  invert,  and  T(^  a  width  function 
which  relates  the  cross  section  width  to  the  distance  above  the  channel  invert. 


If  Fp  is  the  pressure  force  in  the  x-direction  at  the  midpoint  of  the  control  volume,  the 
force  at  the  upstream  end  of  the  control  volume  may  be  written  as: 


:  -  ^ 

^  ax  2 
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and  at  the  downstream  end  as: 
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Figure  A-2  Illustration  of  Terms  Associated  with  Definition  of  Pressure  Force. 
The  sum  of  the  pressure  forces  for  the  control  volume  may  therefore  be  written  as: 


Ax 

^  dx 

2 

^  dx  2 

(A-9) 


where  Fg  is  the  force  exerted  by  the  banks  in  the  x-direction  on  the  fluid.  This  may  be 
simplified  to: 


Ax  +  Fa 


(A-10) 


Differentiating  equation  A-2  using  Leibnitz's  Rule  and  then  substituting  in  equation  A-3 
results  in: 


pjfAx  (ni,)d£.  *  .  F 

dx  j  J  dx 


(A-11) 


The  first  integral  in  equation  A-1 1  is  the  cross-sectional  area,  A.  The  second  integral 
(multiplied  by  -pgAx)  is  the  pressure  force  exerted  by  the  fluid  on  the  banks,  which  is 
exactly  equal  in  magnitude,  but  opposite  in  direction  to  Fg.  Hence  the  net  pressure 
force  may  be  written  as: 


(A-1 2) 
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Gravitational  force  The  force  due  to  gravity  on  the  fluid  in  the  control  volume  in 
the  x-direction  is: 


pgA  sin0  Ax 


(A-13) 


where  6  is  the  angle  that  the  channel  invert  makes  with  the  horizontal.  For  natural 
rivers  ^is  small  and  sin  0  -  tan  9=  -dzjdx.,  where  Zq  is  the  invert  elevation.  Therefore 
the  gravitational  force  may  be  written  as: 

=  (A-14) 

This  force  will  be  positive  for  negative  bed  slopes. 

Boundary  drag  (friction  force)  Frictional  forces  between  the  channel  and  the  fluid 
may  be  written  as: 


-  To  P  Ax 


(A-15) 


where  is  the  average  boundary  shear  stress  (force/unit  area)  acting  on  the  fluid 
boundaries,  and  P  is  the  wetted  perimeter.  The  negative  sign  indicates  that  with  flow  in 
the  positive  x-direction,  the  force  acts  in  the  negative  x-direction.  From  dimensional 
analysis,  may  be  expressed  in  terms  of  a  drag  coefficient,  Cp,  as  follows: 

To  =  P  Cp  (A-16) 

The  drag  coefficient  may  be  related  to  the  Chezy  coefficient  Cby  the  following: 

Co  =  (A-17) 

Further,  the  Chezy  equation  may  be  written  as: 

V  =  C  (A-18) 


Substituting  equations  A-16,  A-17  and  A-18  into  A-15,  and  simplifying,  yields  the 
following  expression  for  the  boundary  drag  force: 

Ff  =  -pgASf^x  (A-19) 

where  S,  is  the  friction  slope,  which  is  positive  for  flow  in  the  positive  x-direction.  The 
friction  slope  must  be  related  to  flow  and  stage.  Traditionally,  the  Manning  and  Chezy 
friction  equations  have  been  used.  Since  the  Manning  equation  is  predominantly  used 
in  the  United  States,  it  is  also  used  in  UNET.  The  Manning  equation  is  written  as: 
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Q\Q\n^ 
2.208  mA'‘ 


(A-20) 


where  R  is  the  hydraulic  radius  and  n  is  the  Manning  friction  coefficient. 

Momentum  flux  With  the  three  force  terms  defined,  only  the  momentum  flux 
remains.  The  flux  entering  the  control  volume  may  be  written  as: 


p  QV 


dQV  ^ 
dx  2 


(A-21) 


and  the  flux  leaving  the  volume  may  be  written  as: 


p 

dx  2 


(A-22) 


Therefore  the  net  rate  of  momemtum  (momentum  flux)  entering  the  control  volume  is: 


p^Ax 

ax 


(A-23) 


Since  the  momentum  of  the  fluid  in  the  control  volume  is  pQAx,  the  rate  of 
accumulation  of  momentum  may  be  written  as: 


—  (pOAx)  =  pAx— 
dt  dt 


(A-24) 


Restating  the  principle  of  conservation  of  momentum: 

The  net  rate  of  momentum  (momentum  flux)  entering  the  volume  (A-23)  plus  the 
sum  of  all  external  forces  acting  on  the  volume  [(A-12)  +  (A-14)  +  (A-19)]  is  equal  to  the 
rate  of  accumulation  of  momentum  (A-24).  Hence: 

p  Ax  —  =  -p  Ax  -  pgA  —  Ax  -  pgA  —  Ax  -  pgA  Sf  Ax  (A-25) 
dt  dx  dx  dx 


The  elevation  of  the  water  surface,  z,  is  equal  to  Zq  +  h.  Therefore: 

dx  dx  dx 


(A-26) 
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where  ^3(\s  the  water  surface  slope.  Substituting  (A-26)  into  (A-25),  dividing  through 
by  pAx  and  moving  all  terms  to  the  left  yields  the  final  form  of  the  momentum  equation: 


dQ 

dt 


+ 


dQV 

dx 


/ 

+  gA 

V 


3z 

dx 


+ 


=  0 


(A-27) 


A.3  Skyline  Solution  of  a  Sparse  System  of  Linear  Equations 

The  finite  difference  equations  along  with  external  and  internal  boundary 
conditions  and  storage  area  equations  result  in  a  system  of  linear  equations  which  must 
be  solved  for  each  time  step: 

Ax  ^  b  (A-28) 


in  which:  A  =  coefficient  matrix, 

X  =  column  vector  of  unknowns, 
b  =  column  vector  of  constants. 

For  a  single  channel  without  a  storage  area,  the  coefficient  matrix  has  a  band  width  of 
five  and  can  be  solved  by  one  of  many  banded  matrix  solvers. 

For  network  problems,  sparse  terms  destroy  the  banded  structure.  The  sparse 
terms  enter  and  leave  at  the  boundary  equations  and  at  the  storage  areas.  Figure  A-3 
shows  a  simple  system  with  four  reaches  and  a  storage  area  off  of  reach  2.  The 
corresponding  coefficient  matrix  is  shown  in  Figure  A-4.  The  elements  are  banded  for 
the  reaches  but  sparse  elements  appear  at  the  reach  boundaries  and  at  the  storage 
area.  This  small  system  is  a  trivial  problem  to  solve,  but  systems  with  hundreds  of 
cross  sections  and  tens  of  reaches  pose  a  major  numerical  problem  because  of  the 
sparse  terms.  Even  the  largest  computers  cannot  store  the  coefficient  matrix  for  a 
moderately  sized  problem,  furthermore,  the  computer  time  required  to  solve  such  a 
large  matrix  using  Gaussian  elimination  would  be  very  large.  Because  most  of  the 
elements  are  zero,  a  majority  of  computer  time  would  be  wasted. 
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Figure  A-3  Simple  network  with  four  reaches  and  a  storage  area. 
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Figure  A-4  Sparse  coefficient  matrix  resulting  from  simple  linear  system.  Note,  sparse 
terms  enter  and  disappear  at  storage  areas  and  boundary  equations. 


Three  practical  solution  schemes  have  been  used  to  solve  the  sparse  system  of 
linear  equations:  Barkau  (1 985)  used  a  front  solver  scheme  to  eliminate  terms  to  the 
left  of  the  diagonal  and  pointers  to  identify  sparse  columns  to  the  right  of  the  diagonal. 
Cunge  et  al.  (1980)  and  Shaffranekk  (1981)  used  recursive  schemes  to  significantly 
reduce  the  size  of  the  sparse  coefficient  matrix.  Tucci  (1978)  and  Chen  and  Simons 
(1979)  used  the  skyline  storage  scheme  (Bathe  and  Wilson,  1976)  to  store  the 
coefficient  matrix.  The  goal  of  these  schemes  is  to  more  effectively  store  the  coefficient 
matrix.  The  front  solver  and  skyline  methods  identify  and  store  only  the  significant 
elements.  The  recursive  schemes  are  more  elegant,  significantly  reducing  the  number 
of  linear  equations.  All  use  Gaussian  elimination  to  solve  the  simultaneous  equations. 

A  front  solver  performs  the  reduction  pass  of  Gauss  elimination  before  equations 
are  entered  into  a  coefficient  matrix.  Hence,  the  coefficient  matrix  is  upper  triangular. 

To  further  reduce  storage,  Barkau  proposed  indexing  sparse  columns  to  the  right  of  the 
band;  thus,  only  the  band  and  the  sparse  terms  were  stored.  Since  row  and  column 
operations  were  minimized,  the  procedure  should  be  as  fast  if  not  faster  than  any  of  the 
other  procedures.  But,  the  procedure  could  not  be  readily  adapted  to  a  wide  variety  of 
problems  because  of  the  way  that  the  sparse  terms  were  indexed.  Hence,  the  program 
needed  to  be  redimensioned  and  recompiled  for  each  new  problem. 

The  recursive  schemes  are  ingenious.  Cunge  credits  the  initial  application  to 
Friazinov  (1970).  Cunge's  scheme  and  Schaffranek's  schemes  are  similar  in  approach 
but  differ  greatly  in  efficiency.  Through  recursive  upward  and  downward  passes,  each 
single  routing  reach  is  transformed  into  two  transfer  equations  which  relate  the  stages 
and  flows  at  the  upstream  and  downstream  boundaries.  Cunge  substitutes  the  transfer 
equations  in  which  M  is  the  number  of  junctions.  Schraffranek  combines  the  transfer 
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equations  with  the  boundary  equations,  resulting  in  a  system  of  4N  equations  in  which 
N  is  the  number  of  individual  reaches.  The  coefficient  matrix  is  sparse,  but  the  degree 
is  much  less  than  the  original  system. 

By  using  recursion,  the  algorithms  minimize  row  and  column  operations.  The 
key  to  the  algorithm's  speed  is  the  solution  of  a  reduced  linear  equation  set.  For 
smaller  problems  Gaussian  elimination  on  the  full  matrix  would  suffice.  For  larger 
problems,  some  type  of  sparse  matrix  solver  must  be  used,  primarily  to  reduce  the 
number  of  elementary  operations.  Consider,  for  example,  a  system  of  50  reaches. 
Schaffranek's  matrix  would  be  200  X  200  and  Cunge's  matrix  would  be  50  X  50,  2.7 
million  and  42,000  operations  respectively  (the  number  of  operations  is  approximately 
1/3  where  n  is  the  number  of  rows). 

Another  disadvantage  of  the  recursive  scheme  is  adaptability.  Lateral  weirs 
which  discharge  into  storage  areas  or  which  discharge  into  other  reaches  disrupt  the 
recursion  algorithm.  These  weirs  may  span  a  short  distance  or  they  may  span  an  entire 
reach.  The  recursion  algorithm,  as  presented  in  the  above  references,  will  not  work  for 
this  problem.  The  algorithm  can  be  adapted,  but  no  documentation  has  yet  been 
published. 

Skyline  is  the  name  of  a  storage  algorithm  for  a  sparse  matrix.  In  any  sparse 
matrix,  the  non-zero  elements  from  the  linear  system  and  from  the  Gaussian  elimination 
procedure  are  to  the  left  of  the  diagonal  and  in  a  column  above  the  diagonal.  This 
structure  is  shown  in  Figure  A.4.  Skyline  stores  these  inverted  "L  shaped"  structures  in 
a  vector,  keeping  the  total  storage  at  a  minimum.  Elements  in  skyline  storage  are 
accessed  by  row  and  column  numbers.  Elements  outside  the  "L"  are  returned  as  zero, 
hence  the  skyline  matrix  functions  exactly  as  the  original  matrix.  Skyline  storage  can  be 
adapted  to  any  problem. 

The  efficiency  of  Gaussian  elimination  depends  on  the  number  of  pointers  into 
skyline  storage.  Tucci  (1978)  and  Chen  and  Simons  (1979)  used  the  original  algorithm 
as  proposed  by  Bathe  and  Wilson  (1976).  This  algorithm  used  only  two  pointers,  the 
left  limit  and  the  upper  limit  of  the  "L",  thus,  a  large  number  of  unnecessary  elementary 
operations  are  performed  on  zero  elements  and  in  searching  for  rows  to  reduce.  Their 
solution  was  acceptable  for  small  problems,  but  clearly  deficient  for  large  problems. 
Using  additional  pointers  reduces  the  number  of  superfluous  calculations.  If  the 
pointers  identify  all  the  sparse  columns  to  the  right  of  the  diagonal,  then  the  number  of 
operations  is  minimized  and  the  performance  is  similar  to  the  front  solver  algorithm. 

Skyline  Solution  Algorithm 

The  skyline  storage  algorithm  was  chosen  to  store  the  coefficient  matrix.  The 
Gauss  elimination  algorithm  of  Bathe  and  Wilson  was  abandoned  because  of  its  poor 
efficiency.  Instead  a  modified  algorithm  with  seven  pointers  was  developed.  The 
pointers  are; 

1)  IDIA(IROW)  -  index  of  the  diagonal  element  in  row  IROW  in  skyline 
storage. 
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2)  ILEFT(IROW)  -  number  of  columns  to  the  left  of  the  diagonal. 

3)  IHIGH(IROW)  -  number  of  rows  above  the  diagonal. 

4)  IRIGHT(IROW)  -  number  of  columns  in  the  principal  band  to  the  right  of 
the  diagonal. 

5)  ISPCOL(J,IROW)  -  pointer  to  sparse  columns  to  the  right  of  the  principal 
band. 

6)  IZSA(IS)  -  the  row  number  of  storage  area  IS. 

7)  IROWZ(N)  -  the  row  number  of  the  continuity  equation  for  segment  N. 

The  pointers  eliminate  the  meaningless  operations  on  zero  elements.  This  code 
is  specifically  designed  for  flood  routing  through  a  full  network. 
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This  appendix  contains  a  detailed  description  of  the  data  input  requirements  for 
each  variable  on  each  input  record  in  the  cross  section  (geometry)  input  file  read  by 
CSECT.  Many  of  the  records  described  can  be  omitted  if  their  options  are  not  required. 

The  data  input  structure  mimics  the  fixed  format  style  of  HEC-2.  The  location  of 
the  variables  for  each  input  record  is  designated  by  a  field  number.  Each  record  is 
divided  into  ten  fields  of  eight  columns  each,  except  Field  1 .  A  variable  in  Field  1  may 
only  occupy  columns  3  through  8  because  columns  1  and  2  (called  Field  0)  are 
reserved  for  the  required  record  identification  characters.  Depending  on  the  type  of 
input  record,  variable  types  may  be  real,  integer,  or  logical.  The  values  a  variable  may 
assume  and  the  conditions  for  each  are  described.  Integer  variables  begin  with  the 
letters  I,  J,  K,  L,  M,  or  N  (the  standard  FORTRAN  convention).  Integer  fields  must  not 
contain  a  decimal  point.  Logical  variables  are  given  the  values  T  (true)  or  F  (false).  All 
other  variables  are  real  numbers. 

Some  variables  call  for  use  of  program  options  by  using  the  numbers  -1 , 0, 1  or 
10.  Other  variables  are  assigned  numbers  expressing  the  magnitude  of  the  variable. 
For  these,  a  plus  or  minus  sign  is  shown  in  the  description  under  “Value"  and  the 
numerical  value  of  the  variable  is  entered  as  input.  Where  the  value  of  a  variable  is  to 
be  assigned  a  value  of  zero,  the  field  may  be  left  blank  because  a  blank  field  is  read  as 
zero. 


Any  number  without  a  decimal  point  must  be  right  justified  in  its  field.  Any 
number  without  a  sign  is  considered  to  be  positive.  The  codes "+"  and  under 
"Value"  indicate  positive  and  negative  numbers. 

It  is  suggested  that  the  extensions  .OS  and  .CSO  be  used  when  naming  the 
input  and  output  files  for  CSECT. 


Changes  from  Ver.  2.1,  May  1993  UNET  User’s  Manual 

Changed  Records: 

LV  -  Levee  and  Breach  Descriptions  (deleted,  replaced  by  SF  and  EF) 


ZD  -  HEC-DSS  Filename  .  B-13 

XK  -  Limits  of  Cross  Section  Elevation  vs. 

Hydraulic  Properties  Tables  .  B-19 

PC  -  Low  Flow  Pilot  Channel .  B-24 

SP  -  In  Line  Spillway .  B-48 

RW  -  Weir  Flow  Rating  Curves  .  B-77 

RC  -  Rating  Curve  at  a  Cross  Section .  B-78 

FA  -  Use  of  Exponential  Equations  Rather  than  a  Family  of 

Rating  Curves .  B-80 
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New  Records: 

ZX  -  Read  Limits  for  Cross  Section  Tables  from  DSS  .  B-16 

ZN  -  Read  Invert  Profile  from  DSS .  B-17 

ZF  >  Read  Reference  Water  Surface  Profile  from  DSS  .  B-18 

BF  -  Adjust  Floodplain  Area  and  Conveyance  .  B-26 

EN  -  Define  Encroachments  for  a  Conventional  Floodway  Analysis  .  B-27 

DF  -  Define  Encroachments  for  a  Density  Floodway  Analysis  .  B-28 

HV  -  Store  Computed  Velocities  in  DSS .  B-42 

SL  -  Lateral  Simple  Spillway  Connection  to  a  Storage  Area .  B-46 

SS  -  Simple  Spillway  Connecting  Two  Storage  Areas  .  B-47 

CO  -  Combine  Families  of  Rating  Curves .  B-81 

TN  -  Circular  Tunnel  .  B-85 

TB  -  Rectangular  Tunnel .  B-87 

TE  -  Elevations  for  Top  Width  Table .  B-89 

TC  -  Channel  Top  Widths . B-89 

TL  -  Top  Width  of  Left  Overbank .  B-90 

TR  -  Top  Width  of  Right  Overbank .  B-90 

TS  -  Top  Width  of  Storage  Region .  B-91 

SF  -  Simple  Embankment  Failure .  B-92 

EF  -  Embankment  Failure .  B-94 

Include  Files  .  B-96 
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PR 

PR  Record  -  Output  File  Print  Control  -  (Optional  Record) 

The  PR  Record  can  be  used  prior  to  any  X1  Record  to  control  the  detailed  output 
of  cross  section  and  hydraulic  structure  data.  CPRINT  is  a  toggle  switch  that  can  be 
used  to  turn  the  output  on  or  off  as  required.  Note:  If  the  PR  Record  is  not  used,  the 
elevation  vs.  hydraulic  property  tables  will  not  be  written  to  the  CSECT  output  file. 


Sis 

Variable 

Value 

Description 

ID 

PR 

Record  identification. 

1 

CPRINT 

ON 

Begin  writing  elevation  vs.  hydraulic  property  tables 
to  the  CSECT  output  file. 

OFF 


Stop  writing  data. 
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T1  -  T3 

T1  ■  T2.  T3  Title  Records  -  (Required  Records) 

Three  Title  Records  are  required  at  the  beginning  of  each  reach.  TITLE1  is  used 
as  the  A  part  of  DSS  pathnames  written  by  the  TABLE  program.  TITLE2  and  TITLES 
provide  additional  documentation. 


Field 

Variable 

Value 

Description 

0 

ID 

T1 

Record  identification 

1  - 10 

TITLE1 

Alpha 

River  name  and  reach  number.  If  using  more 
than  one  reach.  TITLE  1  should  be  unique  for 
each  reach,  as  it  is  used  as  the  A  part  of  the 
DSS  pathname  for  computed  hydrographs. 

0 

ID 

T2 

Record  identification 

1  -10 

TITLE2 

Alpha 

Project  name  or  other  information. 

0 

ID 

TS 

Record  identification 

1  -10 

TITLES 

Alpha 

User  name,  office  name,  date,  or  other 
information. 
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J1 

J1  Record  -  Cross  Section  Plots  Using  PLOT2  -  (Optional  Record) 

The  J1  Record  is  required  to  make  the  CSECT  input  file  fully  compatible  with  the 
HEC-2  plotting  program,  PLOT2.  It  is  not  a  required  record,  but  without  it  the  first  and 
second  titles  for  cross  section  plots  are  not  plotted.  The  J1  Record  should  be  added  if 
the  titles  are  desired  for  report  quality  graphics.  The  record  must  be  inserted  after  the 
Title  Records  for  the  first  reach.  In  addition,  the  XI  Records  of  the  plotted  cross 
sections  must  have  a  unique  cross  section  number  (SECNAM)  in  field  1 . 

Field  Variable  Value  Description 

0  ID  J1  Record  identification. 


1-10 


Blank. 


EJ 


EJ  Record  -  End  of  Job  -  (Required  Record) 

The  EJ  Record  indicates  the  end  of  the  CSECT  input  file,  and  is  required  as  the 
last  record  in  the  file. 


Field  Variable  Value 


0  ID  EJ 


Description 
Record  identification. 


ZD 

ZD  Record  -  Specify  DSfi  fHp  Marno  .  (Optional  Record) 


The  ZD  Record  identifies  the  DSS  file  name  to  be  used  for  which  data  will  be  read 
or  written  for  the  Zl,  ZA,  ZX  and  ZN  Records.  In  addition,  the  ZD  Record  defines  the 
F-part  for  DSS  pathnames  which  are  written  to  DSS.  The  two  variables  are  in  free 
format,  separated  by  spaces  or  commas.  The  F-part  may  have  any  internal  spaces 
since  It  IS  the  last  item  of  data  on  the  record.  The  ZD  Record  can  be  placed  anywhere 
in  the  CSECT  input  file,  but  it  must  precede  any  ZA  or  Zl  Records. 


Variable  Value _  Description 


Appendix  B  -  CSECT  Input  Date  Description 


DSS  Control  Records 


-  writg  Area  and  Conveyance  tn  p.QQ  .  (Optional  Record) 

written^to  SI  n  conveyance  tables  for  cross  sections  be 

rS  tSc  DSS  file  specified  on  the  ZD  Record.  The  tables  are  written  in  paired  data 
format.  T^is  record  should  be  placed  before  the  cross  section  for  which  you  would  like 

tables  following  the  cross  section  at  which  you  want  to  stop  writing 


Field 

Variable 

Value^^ 

Description 

0 

ID 

"""ZA . 

Record  identifier. 

1 

CONT 

ON 

Start  writing  tables. 

OFF 


Cease 


DSS  Control  Records _ Appendix  B  -  CSECT  Input  Data  Description 


The  Zl  Record  directs  that  the  cross  section  invert  profile,  the  bank  line  profiles, 
and  the  pilot  channel  invert  profile  be  written  to  DSS.  The  parameter  is  entered  in  free 
format.  This  record  must  be  placed  before  the  UB  Record  of  the  reach  that  you  would 
like  to  include  in  the  profile  plots.  It  must  be  preceded  by  a  ZD  Record.  Place  a  Zl  OFF 
Record  after  the  DB  of  the  reach  of  interest  to  terminate  this  option. 


Field 

Variable 

Value 

Description 

0 

ID 

Zl 

Record  identifier. 

1 

UNITS 

Char. 

Units  along  the  distance  axis  (MILES)  and  start 
writing  tables.  Currently  the  program  only  uses 
"MILES". 

OFF 

Cease  writing  invert  profile. 

Example: 

T1 

T2 

T3 


ZD  DSS  FILENAME  F-part 
Zl  MILES 
UB 


DB 

Zl  OFF 
(next  reach) 
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DSS  Control  Records 


zx 

ZX  Record  -  Read  Limits  for  Cross  Section  Tables  from  DSS  -  (Optional  Record) 

This  record  directs  that  the  maximum  and  minimum  water  surface  profiles  be  read 
from  DSS.  The  DSS  pathname  references  a  paired  function  record  which  stores  the 
two  curves.  The  CSECT  program  uses  these  maximum  and  minimum  values  for  the 
limits  of  the  cross  section  tables  if  the  value  of  ELSTRT  is  negative  on  the  XK  Record. 
The  program  determines  the  elevation  increment  from  these  limits  and  the  maximum 
number  of  increments  for  which  the  program  is  dimensioned. 

0  ID  ZX  Record  identifier. 


1-10  PN 


Alpha 


DSS  paired  data  pathname. 


DSS  Control  Records 


Appendix  B  -  CSECT  Input  Data  Description 


This  record  directs  that  an  invert  profile  be  read  from  DSS.  The  DSS  pathname 
references  a  paired  function  record  which  stores  a  single  curve.  The  CSECT  program 
uses  this  invert  value  as  the  base  for  the  cross  section  table  if  ELSTRT  is  negative  on 
the  XK  Record.  If  the  invert  from  the  profile  is  below  the  invert  from  the  cross  section 
and  no  pilot  channel  is  specified,  then  the  higher  invert  is  used.  If  a  pilot  channel  (PC 
Record)  is  present,  then  the  invert  from  the  profile  is  always  the  top  of  the  pilot  channel 
and  the  start  of  the  table. 


Field 

Variable 

Value 

Description 

"o’™" 

ID 

ZN 

Record  identifier. 

1-10 

PN 

Alpha 

DSS  paired  data  pathname. 
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DSS  Control  Records 


ZF 

ZF  Record  -  Read  Reference  Water  Surface  Profile  from  DSS  -  (Optional  Record) 

This  record  directs  CSECT  to  read  the  profile  of  a  reference  water  surface  (base 
flood)  from  DSS.  The  DSS  filename:  pathname  references  a  paired  function  file.  It  is 
necessary  to  use  the  ZF  Record  when  doing  floodway  analysis. 

Floodway  computations  are  based  on  the  one-percent  chance  flood  (base  flood). 
The  base  flood  is  routed  through  the  study  reach  for  existing  conditions  and  the 
resulting  maximum  water  surface  profile  is  written  to  a  DSS  file  (see  Job  Control 
variable  PZMX  in  UNET  input).  In  a  separate  floodway  run,  the  base  flood  profile  is 
read  with  the  ZF  Record  specifying  the  pathname  and  the  EN  or  DF  Record  defining  the 
encroachment  as  a  fraction  of  the  flow  and  storage  area.  Note:  this  option  is  not  based 
on  conveyance  reduction. 

Field  Variable  Value  Description 

0  ID  ZF  Record  identifier. 

1-10  PN  Alpha  DSS  paired  data  pathname.  (Syntax  is  filename: 

pathname.) 


Cross  Section  Chanpe  Records 


Appendix  B  -  CSECT  Input  Data  Description 

XK 


XK  Record  -  Limits  of  Cross  Section  Elevation  vs.  Hydraulic  Property  Tables  - 
(Required  Record) 

This  record  defines  the  starting  elevation  and  the  elevation  intervals  in  the  area 
and  conveyance  vs.  elevation  (hydraulic  properties)  tables.  It  also  sets  the  initial 
maximum  distance  between  interpolated  cross  sections  (nodes).  It  must  appear  before 
the  first  cross  section  (XI  Record),  but  it  can  appear  before  any  or  all  subsequent  cross 
sections  to  change  the  parameters.  CSECT  has  several  ways  of  specifying  the  starting 
point  for  the  cross  section  tables: 

1)  Enter  BELBK  and  ELINC  in  fields  1  and  5  respectively.  The  CSECT  program 
starts  the  table  at  the  minimum  elevation  of  the  channel  bank  minus  BELBK.  If  the 
starting  point  is  below  the  invert  of  the  cross  section  (i.e.  BELBK  is  too  large  a  value), 
then  the  starting  elevation  is  set  at  the  invert  elevation  plus  one  foot.  The  elevation 
increment  in  the  tables  is  ELINC.  The  number  of  vertical  points  in  the  hydraulic 
properties  table  is  shown  in  the  CSECT  output  file  under  the  heading  “PROGRAM 
DIMENSIONS”. 

2)  The  table  is  based  on  a  slope  profile,  entered  manually,  which  defines  the 
upper  limit  of  the  table.  The  starting  elevation  is  entered  as  ELSTRT  in  field  3  and  the 
slope  of  the  profile  is  entered  as  SLOPE  in  field  4.  The  table  is  started  at  a  distance 
RISE  below  the  profile  and  at  an  increment  of  ELINC.  All  subsequent  tables  will  be 
based  on  this  profile  until  another  XK  Record  is  encountered  which  either  redefines  the 
slope  profile  or  directs  another  method  for  starting  the  table. 

3)  The  table  is  based  on  a  invert  profile  read  from  DSS  either  on  a  ZN  or  ZX 
Record.  This  option  is  enabled  by  entering  a  ELSTRT  value  of  -1  in  field  2.  The  table 
has  an  increment  of  ELINC. 


0  ID  XK  Record  identification, 

1  BELBK  +  The  first  elevation  above  the  invert  will  be  located 

BELBK  feet  below  the  lower  bank  elevation  (XSTL 
or  XSTR  on  X1  Record).  A  value  larger  than  the 
channel  depth  will  set  this  point  one  foot  above 
the  invert  elevation. 


2  RISE  +  Elevation  span  of  the  table.  This  is  computed 

automatically  based  on  ELINC  (field  5).  Older 
versions  of  the  program  required  RISE  to  be 
specified.  Field  2  is  now  ignored 
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Cross  Section  Change  Records 


XK  (Cont.) 

Field  Variable  Value  Description 

3  ELSTRT  +  Starting  elevation  for  slope  profile. 

0  Do  not  use  profile. 

-1  Use  profile  read  from  DSS  on  either  ZN  or  ZX 

Record. 


4  SLOPE  + 

5  ELINC  + 


6  XMINC  + 

7  FM  + 


Slope  of  the  profile. 


Elevation  increment.  The  tables  will  consist  of  the 


number  of  points  shown  in  the  “PROGRAM 
DIMENSIONS”  table  in  the  output  file  plus  the 


The  first  elevation  above  the  invert  will  be 


computed  based  on  the  selection  of  BELBK.  The 
selection  of  ELINC  should  be  based  on  the 


maximum  anticipated  depth  at  the  current  cross 
section.  Additional  XK  Records  should  be 


inserted  throughout  the  input  file  so  that  the 
elevation  table  bounds  the  maximum  water 


surface  elevation  profile  while  providing  high 
resolution  where  geometric  properties  are  rapidly 
changing.  Some  adjustment  to  XK  limits  should 
be  expected  as  a  model  is  being  developed. 


Maximum  interval  in  miles  between  interpolated 
cross  sections  (nodes). 

Factor  to  adjust  SECNAM  on  XI  Record  to  the 
units  of  miles. 


0  Do  not  adjust  SECNAM. 


8  CMILE  +  River  mile  of  the  first  cross  section.  The  river  miles 

of  all  subsequent  cross  sections  are  calculated 
from  the  channel  distance.  (This  will  not  affect 
SECNAM  but  will  change  the  output  to  units  of 
miles.) 


0 


The  river  mile  of  the  cross  section  is  accepted  as 
SECNAM  on  the  XI  Record. 
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Cross  Section  Change  Records 


XI 


XI  Record  -  Interpolated  Cross  Section  Interval  -  (Optional  Record) 

This  record  defines  the  maximum  distance  in  the  x-direction  between  interpolated 
cross  sections.  (Note,  actual  cross  sections  are  not  interpolated;  however,  additional 
computational  nodes  are  inserted  at  the  intervening  locations.)  It  can  be  used  prior  to 
any  X1  Record  to  change  the  distance  set  by  XMINC  (XK.6)  without  having  to  use  a 
complete  XK  Record. 

__Fie|d _ Variable  Value  Description 

0  ID  XI  Record  identification. 

1  XING  +  Maximum  interval,  in  miles,  between  interpolated 

_ _  nodes. 
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Cross  Section  Change  Records 


NC 

NC  Record  -  Manning's  n  Values  -  (Required  Record) 

The  NC  Record  defines  Manning's  n  values  for  the  channel  and  overbanks.  The 
expansion  and  contraction  loss  coefficients  entered  in  fields  4  and  5  of  HEC-2  files  are 
not  used  in  UNET.  These  losses  are  treated  as  internal  forces  by  the  program. 
Structures  such  as  bridge  piers,  navigation  dams  and  cofferdams  constrict  flow  and 
exert  additional  forces  which  oppose  the  flow.  In  localized  areas  these  forces 
predominate  and  produce  a  significant  swell  head  upstream  of  the  structure.  Field  6 
provides  a  method  to  include  these  forces.  Refer  to  Section  2.4  of  this  manual  for 
further  details.  The  NC  Record  is  required  prior  to  the  first  cross  section  and  may  be 
used  to  change  the  parameters  at  any  subsequent  cross  section. 


Field 

Variable 

Value 

Description 

0 

ID 

NC 

Record  identification. 

1 

XNL 

+ 

Manning's  n  for  left  overbank. 

2 

XNR 

+ 

Manning's  n  for  right  overbank. 

3 

XNCH 

+ 

Manning's  n  for  channel. 

4 

Blank  field 

HEC-2  contraction  coefficient,  not  used  in  UNET. 

5 

Blank  field 

HEC-2  expansion  coefficient,  not  used  in  UNET. 

FNCH1 

+ 

Loss  coefficient  for  optional  added  head  loss  term. 
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NH 


NH  Record  -  Horizontal  Variation  in  Manning's  n  -  (Optional  Record) 

Used  to  change  the  roughness  coefficients  to  vary  with  horizontal  distance  from 
the  left  side  of  the  cross  section.  Roughness  coefficients  should  be  redefined  for  each 
cross  section  that  has  new  geometry. 


Field 

Variable 

Value 

Description 

0 

ID 

NH 

Record  identification. 

1 

NHS 

+ 

Total  number  of  Manning's  n  values  (maximum  of 
25)  entered  on  NH  Records.  If  NHS  is  greater 
than  four,  multiple  NH  Records  are  required,  and 
the  first  field  on  the  second  and  subsequent  NH 
Records  should  contain  a  HS(I)  value. 

2,4.6, 

HN(I) 

+ 

Manning’s  n  value  between  stations  HS(I-1)  and 
HS(I).  The  n  value  applies  from  the  starting  left 
station  up  to  HS(I)  (Field  3). 

3.5.7, 

HS(I) 

+ 

Station  corresponding  to  HN(I).  These  stations  do 
not  need  to  match  an  existing  station  on  GR 
Records.  Stations  must  be  input  in  increasing 
order. 
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PC 


Cross  Section  Change  Records 


PC  Becord  -  Low  Flow  Pilot  Channel  -  (Optional  Record) 

The  PC  Record  cuts  a  pilot  channel  into  the  bottom  of  a  cross  section  defined  on 
GR  Records.  Very  wide  and  shallow  cross  sections  which  pass  flows  at  small  depths 
are  difficult  to  model  (problems  with  the  backwater  initial  conditions  or  supercritical  flow 
regimes)  under  low  flow  conditions.  To  assist  the  model  in  solving  these  cross 
sections,  a  pilot  channel  is  cut  into  the  section.  The  pilot  channel  provides  greater  flow 
depths  at  low  discharges.  The  area  and  conveyance  of  the  pilot  channel  are  borrowed 
from  the  lower  part  of  the  entered  cross  section  so  that  the  total  area  and  conveyance 
properties  of  the  cross  section  relate  to  the  original  cross  section  at  higher  flows.  Note 
that  cross  sections  with  pilot  channels  will  compute  unrealistically  low  stages  for  very 
low  flows. 


All  cross  sections  following  the  PC  Record  will  have  pilot  channels  cut  into 
them.  The  pilot  channel  option  is  turned  off  with  a  second  PC  Record  with  the  string 
'OFF  located  anywhere  in  columns  3-80. 


Field 

Variable 

Value 

Description 

0 

ID 

PC 

Record  identification. 

1 

PCTW 

+ 

Width  of  pilot  channel  (ft). 

2 

PCHT 

+ 

Depth  of  pilot  channel  below  section  invert  (ft). 

0 

Minimum  elevation  of  pilot  channel  entered  in  field 
4. 

3 

PCN 

+ 

Manning's  n  for  pilot  channel  conveyance. 

4 

PCZMIN 

+ 

Minimum  elevation  of  pilot  channel.  If  PZMIN  is 
above  the  channel  invert,  then  no  pilot  channel  will 
be  cut. 

0 

Use  PCHT  in  field  2. 
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Cross  Section  Change  Records 


OB 


QB  Record  -  Modify  Qverbank  Storage  -  (Optional  Record) 

The  OB  Record  is  used  to  adjust  storage  in  the  channel  and  overbank  areas.  It  is 
placed  between  the  cross  sections  where  the  change  in  storage  occurs.  This  option  is 
useful  to  adjust  HEC-2  data  files  that  do  not  correctly  model  storage.  The  change  in 
storage  will  be  reflected  in  each  cross  section  following  the  OB  Record.  To  turn  this 
option  off,  insert  a  second  OB  Record  with  FCSTOR  and  FVSTOR  set  equal  to  0.0. 


Field 

Variable 

Value 

Description 

0 

OB 

Record  identification. 

1 

FCSTOR 

+ 

Increment  storage  by  FCSTOR  *  AREA  of 
channel. 

2 

FVSTOR 

+ 

Increment  storage  by  FVSTOR  *  AREA  of  the 
overbank. 
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Cross  Section  Change  Records 


BF 


BF  Record  -  Adjust  Floodplain  Area  and  Conveyance  -  (Optional  Record) 

The  BF  Record  adjusts  the  overbank  flow  and  storage  area  by  a  factor  or  confines 
the  overbank  flow  area  to  a  set  floodway  width.  If  the  floodway  width  option  is  selected, 
the  area  outside  the  floodway  is  redefined  as  storage  area.  The  BF  Record  overrides 
the  encroachments  that  are  specified  on  the  X3  Record.  It  remains  in  effect  until  turned 
off  by  another  BF  Record. 


^sldVariable^Val^ 
0  ID  BF 

1  FVALLEY  + 

0 


Description 
Record  identification. 

Multiply  overbank  flow  area,  conveyance,  and 
storage  by  FVALLEY. 

Not  used. 


2  BFWFWY  +  Width  of  the  active  flow  floodway. 


0 


Not  used. 


Cross  Section  Change  Records 


Appendix  B  -  CSECT  Input  Data  Description 


EN 

EN  Recorci.-  Define  Encroachments  for  a  Conventional  Floodwav  Analysis  -  (Optional 
Record) 

The  EN  Record  defines  encroachments  for  a  conventional  floodway  analysis.  To 
use  this  option,  a  baseflood  profile  for  existing  conditions  must  be  computed  and  written 
to  a  DSS  file  (see  ZF  description  on  page  B-18).  Area  is  removed  starting  from  the 
outer  limits  of  the  cross  section,  as  defined  by  the  base  flood. 


Field 

Variable 

Value 

Description 

0 

ID 

EN 

Record  identification. 

1 

ENPAR 

+ 

Fraction  (ratio)  of  the  total  active  flow  and  storage 
area  in  the  overbank  to  be  removed.  Remaining 
area  is  in  the  floodway. 

0 

If  ENPARL  or  ENPARR  is  specified. 

OFF 

Cease  floodway  accounting. 

2 

ENPARL 

+ 

Fraction  of  the  total  active  flow  and  storage  area  in 
the  left  overbank  to  be  removed  to  define  the 
floodway. 

3 

ENPARR 

Fraction  of  the  total  active  flow  and  storage  area  in 
the  right  overbank  to  be  removed  to  define  the 
floodway. 
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Cross  Section  Change  Records 


DF 

PF  Record  -  Define  Encroachments  for  a  Density  Floodway  Analysis  •  (Optional 
Record) 

The  DF  Record  defines  encroachments  for  a  density  floodway  analysis.  To  use 
this  option,  a  baseflood  profile  for  existing  conditions  must  be  computed  and  written  to  a 
DSS  file(see  ZF  description  on  page  B-18). 

0  ID  DF  Record  identification. 

1  FDF  +  Fraction  of  the  total  active  flow  and  storage  area  In 

the  overbank  to  be  redefined  as  a  density 
floodway.  Method  assumes  the  fraction  is 
proportionally  lost. 


0 


Stop  density  floodway  calculations. 


Cross  Section  Change  Records 
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1C 


1C  Record-Ice  Cover  Data  -  {Optional  Record) 

The  1C  Record  is  used  to  input  or  change  ice  data.  Calculations  with  a  floating  ice 
cover  will  start  at  the  first  cross  section  following  the  1C  Record  and  will  continue  until  an 
1C  Record  is  read  that  has  a  negative  value  for  SPGR  (Field  5).  Ice  calculations  will  not 
be  performed  for  areas  outside  the  encroachment  stations  specified  on  the  X3  Records. 
Pilot  channel  calculations  are  not  affected  by  the  presence  of  the  ice  cover. 

The  use  of  an  1C  Record  will  not  effect  any  of  the  existing  data  output  options  that 
can  be  specified  for  writing  UNET  data  to  an  output  data  file  or  a  DSS  datafile. 

However,  when  an  1C  Record  is  detected  additional  data  will  be  written  to  the  CSECT 
output  file  and  additional  data  may  be  written  to  the  DSS  datafile. 

The  CSECT  output  file,  specified  by  the  user  through  the  program  RUNUNET,  will 
contain  information  describing  the  ice  conditions  at  each  cross  section  where  ice  is 
specified  on  the  1C  Record.  This  data  will  consist  of  the  ice  thicknesses,  the  ice 
Manning's  n  and  the  ice  specific  gravity.  The  tables  printed  by  CSECT  will  reflect  the 
modifications  in  conveyance  and  area  caused  by  the  ice  cover. 

All  data  requested  by  the  user  to  be  written  to  the  DSS  datafile  will  be  written 
without  modification  to  the  file.  In  addition,  if  the  user  has  selected  the  Job  Control 
Option  of  program  UNET  to  write  instantaneous  flow  and  elevation  profiles  to  DSS,  the 
instantaneous  elevation  profiles  of  the  top  surface  and  the  bottom  surface  of  the  ice 
cover  will  also  be  written  to  DSS  at  the  same  time  intervals.  The  top  and  bottom  ice 
surface  profiles  will  be  written  only  for  those  reaches  in  which  ice  exists.  If  a  reach  is 
only  partially  ice  covered,  the  water  surface  elevation  will  be  substituted  for  both  the 
top  and  bottom  ice  surface  for  those  portions  of  the  reach  where  ice  does  not  exist  (see 
figures  D-24  to  D-26). 

In  computing  the  ice  thickness,  the  user  supplied  channel  ice  thickness  will  be 
used.  If  the  channel  ice  thickness  is  zero,  then  the  greater  of  the  left  or  right  overbank 
ice  thicknesses  will  be  used.  The  location  and  top  and  bottom  ice  surface  elevations 
will  be  entered  into  DSS  as  paired  data.  The  DSS  pathname  will  be  constructed  with  the 
following  format: 

A  =  'ICE  PROF. '  RNAME 

B  =  Date  AT  Time 

C  =  'LOC.-ICE_ELEV' 

D  Not  used. 

E  Not  used 

F  =  'TOP'  or  'BTM' 
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Cross  Section  Change  Records 


1C  (Cont.) 

where  RNAME  is  the  reach  name  entered  on  the  T1  Record  in  the  CSECT  input  file.  A 
short  summary  of  the  ice  data  will  also  be  listed  at  the  beginning  of  each  output  table 
specified  at  a  cross  section  where  ice  exists.  Ouput  tables  are  only  developed  for  those 
sections  that  have  an  HY  Record. 


Field 

Variable 

Description 

ID 

~\C 

Record  identification 

1 

ZITL 

+ 

Ice  thickness  in  the  left  overbank. 

0 

No  change  in  the  ice  thickness  in  the  left 
overbank. 

-1 

Open  water  in  the  left  overbank. 

2 

ZITR 

+ 

Ice  thickness  in  the  right  overbank. 

0 

No  change  in  the  ice  thickness  in  the  right 
overbank. 

-1 

Open  water  in  the  right  overbank. 

3 

ZITCH 

+ 

Ice  thickness  for  the  channel. 

0 

No  change  in  ice  thickness  in  the  channel. 

-1 

Open  water  in  the  channel. 

4 

ZIN 

+ 

Manning's  n  for  the  ice  cover. 

0 

No  change  in  Manning's  n  for  the  ice  cover. 

5 

SPGR 

+ 

Value  of  ice  specific  gravity. 

0 

No  change  in  specific  gravity  if  a  value  was 
entered  on  a  previous  record.  If  no  value  had 
been  previously  specified,  the  default  value  of 
0.916  will  be  used. 

-1 

No  Ice  calculations  until  another  IC  Record  is 
read. 
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UB 


UB  Record  -  Upstream  Reach  Boundary  Connection  -  (Required  Record) 

The  UB  Record  specifies  the  upstream  boundary  connection(s)  for  a  reach,  A 
maximum  of  four  other  reaches  may  be  connected.  If  the  reach  flows  out  of  a  storage 
area,  the  upstream  boundary  is  connected  to  the  storage  area  by  specifying  the  storage 
area  as  a  negative  value.  If  the  UB  Record  is  left  blank,  the  upstream  boundary 
condition  data  will  be  specified  in  the  UNET  input  file. 


0  ID  UB 

Record  identifier. 

1-4  IRUCON(l)  + 

Number(s)  of  reach(s)  connected  to  the  upstream 
reach  boundary. 

- 

Number  of  storage  area  connected  to  the 
upstream  reach  boundary. 

Blank 

Upstream  boundary  condition  data  specified  in 
UNET  input  file. 
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Reach  Connection  Reocrds 


DB 

DB  Record  -  Downstream  Reach  Boundary  Connection  -  (Required  Record) 

The  DB  Record  specifies  the  downstream  boundary  connection(s)  for  a  reach.  A 
maximum  of  four  other  reaches  may  be  connected.  If  the  reach  empties  into  a  storage 
area,  the  downstream  boundary  is  connected  to  the  storage  area  by  specifying  the 
storage  area  as  a  negative  value.  If  the  DB  Record  is  left  blank,  the  downstream 
boundary  condition  data  will  be  specified  in  the  UNET  input  file. 

0  ID  DB  Record  identifier. 

1-5  IRDCON(I)  +  Number(s)  of  reach(s)  connected  to  the 

downstream  reach  boundary. 

Number  of  storage  area  connected  to  the 
downstream  reach  boundary. 


Blank 


Downstream  boundary  condition  data  specified  in 
UNET  input  file. 
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X1  Record  - 

XI 

General  Items  for  Each  Cross  Section  -  fReouired  Record^ 

.  ..  -I  -  Ill  -  ■  .  .1  .  ^  -  1  --  -  -  -  -  , 

This  record  is  required  for  each  input  cross  section  and  is  used  to  specify  the 
cross  section  geometry  and  program  options  applicable  to  that  cross  section.  The 
maximum  number  of  input  sections,  computational  nodes,  etc.  allowed  is  shown  in  the 
CSECT  output  file  under  the  heading  “PROGRAM  DIMENSIONS”. 

Field  Variable  Value  Description 

0 

ID 

XI 

Record  identification. 

1 

SECNAM 

+ 

Cross  section  identification  number  (river  mile  is 
recommended  because  this  value  is  used  for  the 
x-axis  on  profile  plots). 

2 

GPNO 

+ 

0 

Number  of  ground  points. 

Previous  upstream  cross  section  is  repeated  for 
current  section.  GR  Records  are  not  entered  for 
this  cross  section. 

3 

XSTL 

+ 

The  station  of  the  left  bank  of  the  channel.  Must 
be  equal  to  one  of  the  STA(I)  on  next  GR 

Records. 

4 

XSTR 

+ 

The  station  of  the  right  bank  of  the  channel.  Must 
be  equal  to  one  of  the  STA(I)  on  next  GR  Records 
and  equal  to  or  greater  than  XSTL. 

5 

XLLGTH 

+ 

Length  of  left  overbank  reach  between  current 
cross  section  and  next  downstream  cross  section 
(*).  Zero  for  the  last  cross  section  of  the  reach. 

6 

RLGTH 

+ 

Length  of  right  overbank  reach  between  current 
cross  section  and  next  downstream  cross  section 
(*).  Zero  for  the  last  cross  section  of  the  reach. 

7 

XLGCH 

+ 

Length  of  channel  reach  between  current  cross 
section  and  next  downstream  cross  section  (*). 

Zero  for  the  last  cross  section  of  the  reach. 

8 

X 

Unused  HEC-2  parameter. 
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Cross  Section  Records 


X1  (Cont.) 

9  ELADD  +  or  -  Elevation  increment  to  be  added  to  all  GR  and  BT 

low  chord  elevation  data  in  the  current  cross 
section. 


*NOTE:  Distance  between  sections  is  not  considered  at  reach  junctions  as 
continuity  of  flow  and  stage  are  assumed. 
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X2 


X2  Record  -  Optional  Items  for  Each  Cross  Section  (Repeat  Bridge  Table) 

This  record  is  used  to  repeat  the  BT  Records  from  the  previous  cross  section  for 
the  current  cross  section.  The  X2  Record  is  currently  used  only  to  repeat  the  bridge 
table.  Prior  to  reversing  existing  HEC-2  data  files,  it  may  prove  simpler  to  enter  all  BT 
Records  and  skip  the  X2  Record  altogether. 


^Figd 

Variable 

Value 

Description 

ID 

X2 

Record  identification 

1 

Not  read  by  UNET 

2 

Not  read  by  UNET 

3 

IBRID 

Repeat  BT  Records  (bridge  table)  used  on 
previous  cross  section. 

0 


Do  not  repeat  bridge  table. 
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Cross  Section  Records 


X3 


X3-B9Qord  -  Optional  Items  for  Each  Cross  Section  (Effective  Area.  Encroachments) 


^  T-  T  1  -  -  T  T. -T  r  -T  T — f  f  i  t  ^  w  ^  IVI  II  I  IV/t 

This  record  defines  the  storage  areas  in  a  cross  section. 

Field 

Variable 

Value 

Description 

0 

ID 

X3 

Record  identification. 

1 

EFCH 

0 

Total  area  of  cross  section  described  on  GR 
Records  below  the  water  surface  elevation  is  used 
in  the  computations. 

10 

Only  the  channel  area  as  defined  by  (XSTL,  XI  .3) 
and  (XSTR,  XI  .4)  is  used  in  the  computations, 
unless  the  water  surface  elevation  exceeds  the 
elevations  of  the  bank  stations.  This  option  can 
be  utilized  to  contain  flow  between  levees  until 
overtopping  occurs,  if  the  bank  stations  are  coded 
at  the  top  of  the  levees.  EFCHL  and  EFCHR  can 
also  be  used  to  define  the  overtopping  elevations. 

2 

SED 

0 

A  sediment  depth  is  not  specified. 

+ 

Depth  of  sediment,  in  feet,  that  will  be  added  to 
the  channel  invert.  All  elevations  in  the  main 
channel  below  the  invert  +  SED  are  set  equal  to 
the  invert  +SED. 

3 

WFWY 

0 

Floodway  width  is  not  changed  or  specified. 

+ 

Width  of  floodway  to  be  centered  in  the  channel, 
midway  between  the  left  and  right  overbanks. 
Conveyance  and  storage  are  computed  within  the 
floodway,  while  only  storage  is  computed  outside 
the  floodway.  This  width  will  be  used  for  all 
subsequent  cross  sections  unless  changed  by  a 
positive  WFWY  on  the  X3  Record  of  another  cross 
section. 

4 

ELS 

Left  encroachment  station.  All  area  to  the  left  of 
(less  than)  this  station  and  below  ELEL  is  treated 
as  storage  only. 
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X3  (Cont.) 

5  ELEL  +  or  -  Elevation  of  the  left  encroachment.  All  area  below 

this  elevation  and  less  than  station  ELS  has  no 
conveyance,  only  storage.  If  negative,  no 
conveyance  or  storage  will  be  computed.  This 
must  be  used  to  avoid  double-accounting  of  levee 
storage  defined  by  storage  areas  (SURFA,  SA.2). 

6  ERS  +  Right  encroachment  station.  All  area  to  the  right 

of  (greater  than)  this  station  and  below  EREL  is 
treated  as  storage  only. 

7  EREL  +  or  -  Elevation  of  the  right  encroachment.  All  area 

below  this  elevation  and  greater  than  station  ERS 
has  no  conveyance,  only  storage.  If  negative,  no 
conveyance  or  storage  will  be  computed.  This 
must  be  used  to  avoid  double-accounting  levee 
storage  defined  by  storage  areas  (SURFA,  SA.2). 

8  EFCHL  +  If  EFCH=1 0,  EFCHL  overrides  the  elevation  of  the 

channel  left  bank  station  (XSTL,  X1.3). 

9  EFCHR  +  If  EFCH=1 0,  EFCHR  overrides  the  elevation  of  the 

MnuMMwgHmiMssisnHnHVBKnHn^^ 

NOTE:  The  station  data  on  the  X3  Record  must  coincide  with  stations  on  the 
following  GR  Records. 


B-37 


Appendix  B  -  CSECT  Input  Data  Description 


Cross  Section  Records 


X4 

X4  Record  -  Additional  Points  for  a  Cross  Section  -  (Optional  Record) 

The  X4  Record  may  be  inserted  following  records  X1 ,  X2  or  X3  to  insert  additional 
points  that  describe  the  ground  profile  of  the  cross  section.  Stations  of  X4  data  points 
must  fall  within  the  range  of  GR  stations.  The  X4  data  point  is  an  added  point  and 
cannot  be  used  to  replace  any  GR  data  point.  This  option  is  useful  when  modifying 
data  records  for  a  proposed  obstruction  as  it  allows  points  to  be  added  anywhere  in  the 
cross  section. 


Field 

Variable 

Value 

Description 

0 

ID 

X4 

Record  identification. 

1 

X 

+ 

Total  number  of  X4  data  points  to  be  added  to  the 
current  cross  section  GR  data.  If  X  is  greater  than 
four,  multiple  X4  Records  are  required,  and  the 
first  field  of  the  second  and  subsequent  X4 

Records  should  contain  an  ASTA(I)  value. 

2,4, etc  AEL(I) 

+  or- 

Elevation  of  additional  ground  point  corresponding 
to  ASTA(I)  Elevations  added  by  X4  Records  are 
adjusted  by  ELADD  (X1.9).  including  those  on 
repeated  cross  sections. 

3,5,  etc  ASTA(I) 

+ 

Station  of  additional  ground  point.  All  stations 
must  be  less  than  the  maximum  station  on  the  GR 
Records.  The  pairs  of  elevations  and  stations  do 
not  have  to  be  in  any  particular  order. 

NOTE:  If  a  second  X4  Record  is  required  at  this  location,  start  station  and 

elevation  data  in  field  one  of  the  second  and  subsequent  X4  Records. 


Cross  Section  Records 
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zo 


ZO  Record  -  Gaae  Zero  Elevation  -  (Optional  Record) 

This  record  defines  gage  zero  elevation  at  a  cross  section.  The  gage  zero 
elevation  is  subtracted  from  the  computed  water  surface  elevation  to  calculate  a  stage. 
The  ZO  (Z-zero)  Record  is  used  along  with  HY  Records  and  must  be  placed 
immediately  before  the  HY  Record. 

0  ID  ZO  Record  identification. 

1  ZERO  +  or  - _ Gage  zero  elevation  (ft). _ 
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Cross  Section  Records 


OH 

OH  Record  -  Read  Observed  Hydroqraph  -  (Optional  Record) 

The  OH  Record  specifies  the  DSS  pathname  of  an  obsen/ed  hydrograph,  which 
will  be  used  when  developing  macros  for  DSPLAY.  This  allows  macros  to  be 
developed  automatically  to  compare  computed  results  to  observed  data.  The  OH 
Record  should  be  placed  immediately  before  the  corresponding  HY  Record  in  the  input 
file. 


Field  Variable  Value  Description 

0  ID  OH  Record  identification. 

Example: 

OH  /A/B/C/D/E/F/ 

A  through  F  are  the  pathname  parts.  The  pathname  may  be  preceded  by  the  DSS 
filename  followed  by  a  colon  (:);  e.g.,  \path\dssfile;/A/B/C/D/E/F/. 
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HY 


HY  Record  -  Store  Computed  Hydrographs  in  DSS  -  (Optional  Record) 

The  HY  Record  is  used  to  write  computed  stage,  elevation  and  flow  hydrographs 
for  the  current  cross  section  to  the  UNET  output  file  and  to  the  DSS  file.  They  can  then 
be  plotted  with  DSPLAY.  The  HY  Record  is  placed  after  the  X1  and  ZO  Records.  The 
dimensions  of  the  TABLE  program,  which  actually  does  the  writing  of  the  hydrographs, 
may  be  found  in  its  output  file  under  “PROGRAM  DIMENSIONS”. 


Field 

Variable 

Value 

Description 

0 

ID 

HY 

Record  identification. 

1  -10 

F 

Alpha 

Name  of  cross  section  where  hydrographs  are  to 
be  plotted.  This  name  will  become  the  "B"  part  of 
the  DSS  pathnames  for  the  hydrograph  data. 
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Cross  Section  Records 


HV 

HV  Record  -  Store  Computed  Velocities  in  DSS  -  (Optional  Record) 

The  HV  Record  is  used  to  write  computed  channel,  overbank  and  average  velocity 
hydrographs  for  the  current  cross  section  to  the  DSS  file.  They  can  then  be  plotted  with 
DSPLAY.  The  HV  Record  is  placed  after  the  X1  and  ZO  Records.  The  dimensions  of 
the  TABLE  program,  which  actually  does  the  writing  of  the  hydrographs,  may  be  found 
in  its  output  file  under  “PROGRAM  DIMENSIONS”. 


Field  Variable  Value _ Description 


0  ID 

HV 

Record  identification. 

1-10  F 

Alpha 

Name  of  cross  section  where  hydrographs  are  to 
be  plotted.  This  name  will  become  the  "B"  part  of 
the  DSS  pathnames  for  the  hydrograph  data. 

Cross  Section  Records 
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GR 


GB  Record  -  Ground  Profile  Elevations  and  Stations  -  (Required  Record) 

This  record  specifies  the  elevation  and  station  of  each  point  in  a  cross  section 
used  to  describe  the  ground  profile,  and  is  required  for  each  X1  Record  unless  GPNO 
(X1 .2)  Is  zero.  Cross  sections  should  be  defined  perpendicular  to  the  direction  of  flow. 
Cross  sections  are  required  at  representative  locations  along  a  river  reach  and  at 
locations  where  changes  occur  in  discharge,  slope,  shape,  or  roughness,  at  locations 
where  levees  begin  or  end,  and  at  bridges,  culverts,  spillways,  or  control  structures 
such  as  weirs.  Where  abrupt  changes  occur,  several  cross  sections  should  be  used  to 
describe  the  change  regardless  of  the  distance.  A  thorough  re-evaluation  of  existing 
HEC-2  GR  Records  is  important  when  they  are  being  modified  for  use  in  UNET  to 
ensure  that  storage  is  correctly  represented  as  well  as  conveyance. 


Field 

wmmmm 

Variable 

Value 

Description 

ID 

GR 

Record  identification. 

1 

EL(1) 

+  or- 

Elevation  of  the  first  ground  point.  May  be  positive 
or  negative  (ft). 

2 

STA(1) 

+ 

Station  of  the  first  ground  point  (ft). 

3 

EL(2) 

+  or- 

Elevation  of  the  second  ground  point. 

4 

STA(2) 

+ 

Station  of  the  second  ground  point. 

5-1 0  etc. 

Continue  with  additional  GR  Records  using  up  to  600  points  to  describe  the  cross 
section.  Stations  must  be  in  increasing  order  progressing  from  left  to  right  across  the 
cross  section. 
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Storage  Area  Records 


SA 

SA  Record  -  Storage  Areas  -  (Optional  Record) 

The  SA  Record  defines  a  storage  area.  Storage  areas  may  be  connected  to 
upstream  or  downstream  reach  boundaries,  or  may  be  filled  (and  drained)  through  a 
lateral  spillway.  The  maximum  number  of  storage  areas  allowed  can  be  found  in  the 
CSECT  output  file  under  the  heading  “PROGRAM  DIMENSIONS”.  A  name  can  be 
attached  to  the  storage  area  by  placing  an  HS  Record  after  the  SA  Record.  The  name 
placed  on  the  HS  Record  will  also  be  used  as  the  B  part  of  the  DSS  pathname.  If  the 
user  does  not  supply  an  HS  Record  with  the  SA  Record,  the  default  name  is  SA#, 
where  #  is  the  user  defined  storage  area  number  (IDSAENTERED). 


Field 

Variable 

Value 

Description 

0 

ID 

SA 

Record  identifier. 

1 

IDSAENTERED 

+ 

The  user  defined  storage  area  number. 

2 

SURFA 

+ 

The  surface  area  of  the  storage  in  acres. 

0 

Elevation-volume  relation  will  be  defined  on  a 
subsequent  SV  Record. 

3 

ZOSA 

+ 

Minimum  elevation  of  storage  area. 

4...10 

NSACON 

+ 

Reach  numbers  of  the  reaches  that  use  this 
storage  area  as  a  downstream  boundary  . 

- 

Reach  numbers  of  the  reaches  that  use  this 
storage  area  as  an  upstream  boundary. 

Storage  Area  Records 
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HS 


HS  Record  -  Storage  Area  Name  -  (Optional  Record) 

The  HS  Record  defines  the  name  of  a  storage  area  and  the  B  part  for  the  DSS 
pathname.  The  HS  Record  is  placed  following  the  SA  Record. 


. . Field . 

Variable 

Value 

Description 

0**" 

ID 

HS 

Record  identification 

1-10 

SANAME 

A32 

Name  of  storage  area. 

sv 


SV  Record  -  Elevation-Volume  Rating  for  Storage  Areas  -  (Optional  Record) 

The  SV  Record  allows  the  user  to  define  an  elevation-volume  rating  curve  for 
storage  areas.  The  SV  Record  should  follow  the  corresponding  SA  Record.  A 
maximum  of  20  elevation-volume  points  may  be  entered. 

1.. ..9  ZSAVOL(1)  +or-  Elevation  (ft). 

2.. ..1 0  VOLSA(1 )  +  Volume  of  storage  area  at  ZSAVOL(1 )  in  acre 

feet. 
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Storage  Area  Records 


)imple  SD^^Iw^ 


Record) 


-  (Optional 


The  SL  Record  defines  a  connection  between  a  reach  and  a  storage  area  by  a 
simple  spillway. 


Field  Variable  Value 


Description 


Record  identification 


ICONN 


Storage  area  number. 


ROUTLIN  + 


ROUTOUT  + 


Linear  routing  coefficient  for  flow  into  the  storage 
area  (0  <  ROUTLIN  1.  Generally  about  0.2). 

Linear  routing  coefficient  for  flow  out  of  the 
storage  area  (0  <  ROUTLOUT  ^  1 .  Generally 
about  0.2). 


ZSPUS 


Elevation  of  overflow  crest  upstream. 


Elevation  from  bankline  profile  on  ZB  Record. 


ZSADS 


Elevation  of  overflow  crest  downstream. 


Assume  ZSPUS. 


Elevation  from  bankline  profile  on  ZB  Record. 


RMDS  + 


Downstream  river  mile. 


0 


Overflow  between  bounding  cross  sections. 
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ss 

SS  Record  -  Simple  Spillway  Connecting  Two  Storage  Areas  -  (Optional  Record) 

The  SS  Record  defines  a  simple  spillway  connection  between  two  storage  areas. 
The  flow  Is  defined  from  storage  area  1  to  storage  area  2. 


Field 

Variable 

Value 

Description 

0 

ID 

SS 

Record  identification 

1 

ICONN1 

+ 

Storage  area  number  1 . 

2 

ICONN2 

+ 

Storage  area  number  2. 

3 

ROUT12 

Linear  routing  coefficient  for  flow  from  SA  1  to  SA 

2  (0  <  ROUTL12  ^  1 .  Generally  about  0.2). 

4 

ROUT21 

+ 

Linear  routing  coefficient  for  flow  from  SA  2  to  SA 

1  (0  <  ROUTLOUT  ^  1.  Generally  about  0.2). 

5 

ZSP 

+ 

Elevation  of  spillway  crest. 
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Spillways  and  Navigation  Dams 


SP 

SP  Record  -  In  Line  Spillway  -  (Optional  Record) 

The  SP  Record  defines  an  in  line,  or  cross  channel  spillway.  In  line  spillways  are 
located  between  two  cross  sections  and  may  consist  of  two  structural  components:  (1) 
a  gated  section,  and  (2)  up  to  four  weir  overflow  sections.  UNET  models  radial,  or 
Tainter  type  gates.  For  spillways  with  multiple  gates,  the  individual  gate  widths  are 
lumped  together  into  a  single  width,  with  the  gates  assumed  to  operate  simultaneously. 
The  SP  Record  can  also  be  used  as  a  special  connection  between  two  storage  areas. 


Free  and  submerged  flow  calculations  can  be  performed.  If  the  gate  opening 
equals  or  exceeds  eighty  percent  of  the  flow  depth,  free  flow  is  computed  using  weir 
flow  equations.  The  time  series  of  gate  openings  is  entered  as  an  internal  boundary 


condition  in  the  UNET  input  file.  For  spillways  without  gates,  fields  2  through  10  are 
left  blank.  Weir  sections  are  defined  on  a  WD  Record  immediately  following  the 
SP  Record. 

Field 

Variable 

Value 

Description 

6 

ID 

SP 

Record  identification. 

1 

ZSP 

+ 

Elevation  at  crest  of  spillway  (ft). 

2 

WSP 

+ 

Width  of  spillway  at  crest  (ft).  This  width  is  equal 
to  the  total  width  of  all  gates  in  the  spillway.  Width 
of  weir  sections  should  be  described  on  WD 
Records  placed  immediately  after  the  SP  Record. 

3 

AVH 

0 

Compute  both  free  and  submerged  flow. 

1 

Compute  only  free  flow  (use  only  if  flow  conditions 
are  known) 

4 

CE 

+ 

Discharge  coefficient  (ranges  from  0.6  to  0.8). 

5 

AH 

Trunnion  height  (ft)  (from  ZSP  to  trunnion  pivot 
point). 

6 

AHE 

+ 

Trunnion  height  exponent,  typically  about  0.16  (for 
sluice  gate  set  to  0.0). 

7 

BE 

+ 

Gate  opening  exponent,  typically  about  0.72  (for 
sluice  gate  set  to  1 .0). 

8 

HE 

+ 

Head  exponent,  typically  about  0.62  (for  sluice 
gate  set  to  0.5). 
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SP  (Cont.) 

Field  Variable  Value  Description  _ 

9  QPLT  +  Pilot  discharge  for  leakage  or  to  keep  downstream 

channel  wet  at  low  flows.  An  alternative  is  to  enter 
a  small  lateral  inflow  at  the  spillway  and  to  remove 
an  equivalent  flow  at  the  end  of  the  reach. 

10  CSPNAME  Alpha  Name  of  spillway.  To  be  used  in  boundary 

conditions  file  for  referencing  time  series  of  gate 
_ _ openings. _ 


Appendix  B  -  CSECT  Input  Data  Description 
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LA 


LA  Record  -  Lateral  Spillway  Diverting  Water  into  a  Storage  Area  -  (Optional  Record) 

The  LA  Record  is  used  to  define  a  lateral  spillway  which  diverts  high  flows  out 
of  a  reach  into  an  adjacent  storage  area.  The  LA  Record  is  placed  just  after  the  cross 
section  that  represents  the  upstream  end  of  the  spillway.  The  water  surface  elevation 
used  in  the  computations  is  based  on  the  average  of  the  two  cross  sections  that  bound 
the  spillway.  Except  for  fields  1  and  10,  the  LA  Record  is  input  exactly  as  the  SP 
Record.  Note  that  the  spillway  width  is  measured  along  the  channel,  as  opposed  to 
across  the  channel  in  the  case  of  in  line  (SP  Record)  spillways.  For  spillways  without 
gates,  fields  3  through  10  are  left  blank.  Weir  sections  are  defined  on  a  WD 
Record  immediately  following  the  LA  Record. 


0  ID  LA  Record  identification. 


1  ICONN  + 

2  ZSP  + 

3  WSP  + 

4  S  0 

1 

5  CE  + 

6  AH  + 

7  AHE  + 

8  BE  + 

9  HE  + 


Number  of  the  storage  area  connected  to  the 
spillway. 

Elevation  of  crest  of  spillway  (ft). 

Width  of  spillway  at  crest  (ft).  This  width  is  equal 
to  the  total  width  of  all  gates  in  the  spillway.  Width 
of  weir  sections  should  be  described  on  WD 
Records  placed  immediately  after  the  LA  Record. 

Compute  both  free  and  submerged  flow. 

Compute  only  free  flow  (use  only  if  flow  conditions 
are  known) 

Discharge  coefficient  (rages  from  0.6  to  0.8). 

Trunnion  height  (ft)  (from  ZSP  to  trunnion  pivot 
point). 

Trunnion  height  exponent,  typically  about  0.16  (for 
sluice  gate  set  to  0.0). 

Gate  opening  exponent,  typically  about  0.72  (for 
sluice  gate  set  to  1.0). 

Head  exponent,  typically  about  0.62  (for  sluice 
gate  set  to  0.5). 
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LA  (Cont.) 


Field  Variable  Value  Description _ 

10  CSPNAME  Alpha  Name  of  spillway.  To  be  used  in  boundary 

conditions  file  for  referencing  time  series  of  gate 


Appendix  B  -  CSECT  Input  Data  Description 
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LS 

LS  Record  -  Lateral  Spillway  Diverting  Water  to  Another  Reach  -  (Optional  Record) 

The  LS  Record  is  used  to  define  a  lateral  spillway  which  diverts  high  flows  out 
of  a  reach  to  another  reach,  or  completely  out  of  the  system  being  modeled.  This  may 
occur  as  overflow  from  a  reach  enters  an  adjacent  drainage  network  which  is  not  part  of 
the  river  system  under  study.  The  LS  Record  is  placed  just  after  the  cross  section  that 
represents  the  upstream  end  of  the  spillway.  The  water  surface  elevation  used  in  the 
computations  is  based  on  the  average  of  the  two  cross  sections  that  bound  the  spillway. 
Note  that  the  spillway  width  is  measured  along  the  channel,  as  opposed  to  across  the 
channel  in  the  case  of  in  line  (SP  Record)  spillways.  For  spillways  without  gates, 
fields  4  through  10  are  left  blank.  Weir  sections  are  defined  on  a  WD  Record 
immediately  following  the  LS  Record. 


Field 

Variable 

Value 

Description 

0 

ID 

LS 

Record  identification. 

1 

IRCH 

Reach  number  which  contains  the  connecting 
cross  section. 

2 

RMILE 

+ 

River  mile  of  connecting  cross  section. 

3 

ZSP 

+ 

Elevation  at  crest  of  spillway  (ft). 

4 

WSP 

+ 

Width  of  spillway  at  crest  (ft).  This  width  is  equal 
to  the  total  width  of  all  gates  in  the  spillway.  Width 
of  weir  sections  should  be  described  on  WD 
Records  placed  immediately  after  the  LS  Record. 

5 

CE 

+ 

Discharge  coefficient  (ranges  from  0.6  to  0.8). 

6 

AH 

+ 

Trunnion  height  (ft)  (from  ZSP  to  trunnion  pivot 
point). 

7 

AHE 

+ 

Trunnion  height  exponent,  typically  about  0.16  (for 
sluice  gate  set  to  0.0). 

8 

BE 

+ 

Gate  opening  exponent,  typically  about  0.72  (for 
sluice  gate  set  to  1 .0). 

9 

HE 

+ 

Head  exponent,  typically  about  0.62  (for  sluice 
gate  set  to  0.5). 
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LS  (Cont.) 

10  CSPNAME  Alpha  Name  of  spillway.  To  be  used  in  boundary 


conditions  file  for  referencing  time  series  of  gate 
openings. 
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ND 


ND  Record  -  Navigation  Dam  -  (Optional  Record) 

The  ND  Record  defines  a  navigation  dam.  Insert  ND  Records  after  the  X1 
Record  at  the  dam  location,  with  11 IBC  blank.  Alternatively,  ND  Records  may  be 
inserted  anywhere  if  II  IBC  is  entered.  "Control  point"  refers  to  the  "hinge"  location  for 
hinge  pool  operated  navigation  dams.  The  hinge  point  may  be  defined  on  the  ND 
Record  with  NAVCP  or  on  a  CP  Record  inserted  after  the  XI  Record  at  the  hinge  point 
location.  The  dam  may  contain  up  to  4  uncontrolled  weir  overflow  sections,  defined  on 
a  WD  Record  following  the  ND  Record. 


Field  Variable  Value 
oT  ID  ND^ 

1  II  IBC  0 

+ 

2  NAVCP  0 

+ 

3  ZCP  + 


Record  identification. 

The  navigation  dam  will  be  placed  at  the  location 
defined  by  the  previous  XI  Record  in  the  input  file. 

Input  cross  section  (ICS)*  number  for  location  of 
navigation  dam. 

The  control  or  hinge  point  location  is  either 
defined  on  the  previous  CP  Record  or,  if  no  CP 
Record  is  used,  it  is  located  at  the  previous  XI 
Record  in  the  input  file. 

Input  cross  section  (ICS)*  number  for  location  of 
hinge  point. 

Elevation  of  the  control  point  (ft).  This  elevation 
will  be  maintained  by  navigation  dam  operation  to 
a  tolerance  of  +/- 1 0  percent. 


4  NNAVQI  + 

5  WSP  + 

6  ZSP  + 

7  ZPMIN  + 


Input  cross  section  (ICS)  number  at  the  headwater 
of  the  navigation  pool.  This  location  will  be  the 
first  cross  section  downstream  of  the  next 
upstream  dam,  or  the  first  cross  section  in  a  reach 
with  only  one  dam. 

Width  of  navigation  dam  spillway  (ft). 

Elevation  at  crest  of  spillway  (ft). 

Minimum  navigation  pool  elevation  (ft)  at  the  dam. 
This  is  usually  defined  in  the  navigation  dam's 
design  manual. 
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ND  (Cont.) 


Field 

Variable  Value 

Description 

8 

CE  + 

d'Aubuisson's  contraction  coefficient  (typical  range 
is  0.6  to  0.9  with  0.8  frequently  used  for  design 
purposes  (Chow  1959,  p.  502)). 

- 

Known  swell  head  (ft)  at  the  dam. 

‘Note: 

The  input  cross  section  number  (ICS)  is  determined  by  the  order  of  X1 
Records  in  the  input  file. 
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CP 

CP  Record  -  Navigation  Dam  Control  Point  -  (Optional  Record) 

The  CP  Record  defines  the  location  of  the  control  or  hinge  point  for  a  navigation 
dam.  As  with  the  ND  Record,  the  CP  Record  can  be  inserted  into  the  input  file  in  two 
methods. 

(1)  The  first  method  is  position  dependent.  A  blank  CP  Record  is  inserted  after 
the  X1  Record  at  the  hinge  point  location.  This  record  defines  the  controi  point  for  the 
next  ND  Record  in  the  input  file.  This  method  provides  convenient  self-documenting 
input  files. 

(2)  The  second  method  is  used  when  11 IBC  is  defined  on  the  ND  Records  i.e.,  the 
ND  Records  are  not  position  dependent.  In  this  case,  the  CP  Record  is  placed 
immediately  before  its  associated  ND  Record  with  NAVCP  specified. 

CP  Records  are  aiways  associated  with  the  next  ND  Record  in  the  input  file. 


Field 

Variable 

Value 

Description 

0 

ID 

CP 

Record  identification. 

1 

NAVCP 

0 

The  hinge  point  is  placed  at  the  location  defined 
by  the  previous  XI  Record.  CP  Record  is  position 
dependent. 

+ 

input  cross  section  (ICS)*  number  for  location  of 
hinge  point.  Associated  ND  Record  follows  CP 
Record.  CP  Record  is  not  position  dependent. 

*Note:  The  input  cross  section  number  (ICS)  is  determined  by  the  order  of  XI 
Records  in  the  input  file. 


Normal  Bridge  Record 
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BT 


BT  Record  -  Bridge  Table  of  Elevations  and  Stations  -  (Optional  Record) 

The  BT  Record  defines  the  geometry  of  bridge  structures  and  approach 
embankments.  Bridge  calculations  are  handled  by  a  procedure  similar  to  the  normal 
bridge  method  in  HEC-2.  BT  Records  must  appear  before  the  GR  Records  in  a  cross 
section  definition.  Each  BT  station  must  correspond  to  a  GR  station.  The  program 
eliminates  the  area  between  top-of-road  and  low-chord  profile  defined  by  the  BT  data. 

If  the  top-of-road  is  above  the  overbank  ground  profile,  the  low-chord  elevations  should 
be  equal  to  the  ground  (GR)  elevation  to  fill  in  the  overbank  area  between  road  and 
ground.  Also,  the  top  of  the  roadway  must  connect  to  the  ground  profile  (this  differs 
from  HEC-2). 


Field 

Variable 

Value 

Description 

0 

ID 

BT 

Record  identification. 

1 

X 

+* 

Number  of  points  describing  the  bridge  roadway 
and  low  chord  to  be  read  on  the  BT  Records. 
Entered  only  on  first  BT  Record.  The  maximum 
number  of  points  is  600. 

2 

RSTA(1) 

+ 

Roadway  station  corresponding  to  RHEL(1)  and 
RLEL(1). 

3 

RHEL(1) 

+ 

Top  of  roadway  elevation  at  station  RSTA(1). 

4 

RLEL(1) 

+ 

Low  chord  elevation  at  station  RSTA(1). 

5 

RSTA(2) 

+ 

Roadway  station  corresponding  to  RHEL(2)  and 
RLEL(2). 

6 

RHEL(2) 

+ 

Top  of  roadway  elevation  at  station  RSTA(2). 

7 

RLEL(2) 

+ 

Low  chord  elevation  at  station  RSTA(2). 

8 

RSTA(3) 

+ 

Roadway  station  corresponding  to  RHEL(3)  and 
RLEL(3). 

9 

RHEL(3) 

+ 

Top  of  roadway  elevation  at  station  RSTA(3). 

10 

RLEL(3) 

+ 

Low  chord  elevation  at  station  RSTA(3). 
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Normal  Bridge  Record 


BT  (Cont.) 

•Format  for  Additional  BT  Records 

Standard  format:  If  X  is  positive  (+)  BT  data  RSTA,  RHEL  and  RLEL  is  to  be 
input  starting  in  the  second  and  subsequent  BT  Records,  all  ten  fields  are  available  for 
data. 

Optional  format;  If  X  is  negative  (-)  BT  data  is  to  be  input  in  the  second  through 
the  tenth  fields  of  the  second  and  subsequent  BT  Records,  only  nine  fields  are 
available  for  data. 
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BR 


BR  Record  -  Special  Bridge  Computations  -  (Optional  Record) 

This  record  defines  the  loss  parameters  pertaining  to  a  bridge  crossing.  The 
bridge  crossing  consists  of  two  parts  -  the  bridge  structure,  piers,  chords,  etc.,  which 
resists  the  flow;  and  the  roadway  embankment,  which  acts  as  a  weir.  The  BR  Record  is 
normally  used  for  a  crossing  where  the  roadway  is  overtopped  and  the  embankment 
blocks  a  significant  portion  of  the  floodplain  area;  i.e.,  where  the  open  channel  flow 
equations  and  the  normal  bridge  procedure  (BT  Records)  do  not  apply  and  an  internal 
boundary  condition  must  be  inserted.  The  BR  Record  sets  the  parameters  and  directs 
that  a  family  of  rating  curves  be  defined  for  the  crossing.  Following  the  BR  Record,  a 
WD  Record  can  be  added  to  define  the  weir.  Alternatively,  the  weir  profile  can  be  taken 
from  BT  Records  associated  with  the  prior  cross  section.  A  BL  Record  must  follow  the 
BR  Record  initiating  the  calculation  of  the  rating  curves. 


Field 

Variable 

Value 

Description 

0 

ID 

BR 

Record  identification. 

1 

YK 

Yarnell's  pier  loss  coefficient,  from  0.9  to  1 .25. 

2 

BWP 

+ 

Total  width  of  the  piers. 

3 

PK 

+ 

Pressure  flow  loss  coefficient,  commonly  1 .6 

4 

BELC 

+ 

Bridge  entrance  loss  coefficient  for  free  flow, 
commonly  ranges  from  0.3  to  0.6. 

5 

ZBRLC 

+ 

Low  chord  elevation. 

6 

ZBRHC 

+ 

High  chord  elevation. 

7 

BCW 

+ 

Weir  coefficient  for  flow  over  the  roadway  if  BT 
Records  are  used. 
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BR  (Cont.) 

Values  of  YK  (Yarnell's  Pier  Loss  Coefficient)  for  various  pier  shapes  [1] 


Pipr  Shape  Coefficient 

Semicircular  nose  and  tail  0.9 

Lens-shaped  nose  and  tail  [2]  0.9 

Twin-cylinder  piers  with  connecting  diaphram  0.95 

Twin-cylinder  piers  without  diaphram  1 .05 

90  deg  triangular  nose  and  tail  1 .05 

Square  nose  and  tail  1 .25 


[1]  French,  R.A.,  (1985).  Open-Channel  Hydraulics,  McGraw-Hill  Company,  New 
York,  page  396. 

[2]  A  lens-shaped  nose  or  tail  is  formed  from  two  circular  curves  each  having  a  radius 
of  twice  the  pier  width  and  each  tangential  to  a  pier  face. 
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The  BL  Record  sets  elevation  limits  on  the  family  of  rating  curves  which  are 
computed  for  a  bridge.  The  BL  Record  must  follow  a  BR  and  WD  (if  used)  Record, 
otherwise  the  program  will  abort. 

0  ID  BL  Record  identification 

1  ZTW2  +  Maximum  tailwater  elevation. 

0  Program  will  select  ZTW2  from  upstream  cross 

section  and  weir  data. 

2  ZHW2  +  Maximum  headwater  elevation. 

0  Program  will  select  ZHW2  from  upstream  cross 

section  and  weir  data. 

3  SHMAX  +  Maximum  swell  head  expected  across  the 

roadway  for  roadway  crossings. 
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CA,  CE 


Culvert  Records 


CA  or  CE  Records  -  Arch  or  Elliptical  Culverts  -  (Optional  Record) 

The  CA  (CE)  Record  is  used  to  define  an  arch  (elliptical)  type  culvert.  One  record 
defines  one  culvert.  Up  to  five  culverts  defined  on  CA,  CE,  CB  or  CC  Records  may  be 
entered  for  each  road  crossing,  with  the  culvert  record(s)  immediately  following  the 
cross  section  records  (X1  and  GR).  A  WD  Record  may  follow  the  culvert  records  to 
define  the  weir  overflow  parameters  associated  with  the  roadway  crown.  A  CL  Record 
must  follow  the  culvert(s)  and  weir  records  to  define  elevation  limits  of  the  computed 
culvert  rating  tables  and  to  end  the  culvert  sequence. 


Field 

Variable 

Value 

Description 

0 

ID 

CA  or  CE 

Record  identification. 

1 

RISE 

+ 

Maximum  culvert  height  (ft). 

2 

SPAN 

+ 

Maximum  culvert  width  (ft). 

3 

ZIN 

+ 

Upstream  invert  elevation  (ft). 

4 

ZOUT 

+ 

Downstream  invert  elevation  (ft). 

5 

CLEN 

+ 

Barrel  length  (ft). 

6 

CN 

Manning's  n  value. 

7 

ICCOEFF 

+ 

UNET  index  No.  for  culvert  loss  coefficient  type. 
(Appendix  B,  Page  59) 

8 

IQDIR 

0 

Flow  can  go  in  both  directions  through  the  culvert. 

+1 

Flow  can  only  go  in  the  positive  flow  direction. 

-1 

Flow  can  only  go  in  the  negative  flow  direction. 

9-10 

Blank  fields. 
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CB 


CB  Record  -  Box  Culverts  -  (Optional  Record) 

The  CB  Record  is  used  to  define  a  box  type  culvert.  One  CB  Record  defines  one 
culvert.  Up  to  five  culverts  defined  on  CA,  CE,  CB  or  CC  Records  may  be  entered  for 
each  road  crossing,  with  the  culvert  record(s)  immediately  following  the  cross  section 
records  (X1  and  GR).  A  WD  Record  may  follow  the  culvert  records  to  define  the  weir 
overflow  parameters  associated  with  the  roadway  crown.  A  CL  Record  must  follow  the 
culvert(s)  and  weir  records  to  define  elevation  limits  of  the  computed  culvert  rating 
tables  and  to  end  the  culvert  sequence. 


Field 

Variable 

Value 

Description 

0 

ID 

CB 

Record  identification. 

1 

RISE 

+ 

Maximum  culvert  height  (ft). 

2 

SPAN 

+ 

Maximum  culvert  width  (ft). 

3 

ZIN 

+ 

Upstream  invert  elevation  (ft). 

4 

ZOUT 

+ 

Downstream  invert  elevation  (ft). 

5 

CLEN 

+ 

Barrel  length  (ft). 

6 

CN 

+ 

Manning's  n  value. 

7 

ICCOEFF 

+ 

UNET  Index  No.  for  culvert  loss  coefficient  type. 
(Appendix  B,  Page  59) 

8 

IQDIR 

0 

Flow  can  go  in  both  directions  through  the 
culvert. 

+1 

Flow  can  only  go  in  the  positive  flow  direction. 

-1 

Flow  can  only  go  in  the  negative  flow  direction. 

9-10 

Blank  fields. 
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Culvert  Records 


cc 

CC  Record  -  Circular  Culverts  -  (Optional  Record) 

The  CC  Record  is  used  to  define  a  circular  type  culvert.  One  CC  Record  defines 
one  culvert.  Up  to  five  culverts  defined  on  CA,  CE,  CB  or  CC  Records  may  be  entered 
for  each  road  crossing,  with  the  culvert  record(s)  immediately  following  the  cross 
section  records  (X1  and  GR).  A  WD  Record  may  follow  the  culvert  records  to  define 
the  weir  overflow  parameters  associated  with  the  roadway  crown.  A  CL  Record  must 
follow  the  culveil(s)  and  weir  records  to  define  elevation  limits  of  the  computed  culvert 
rating  tables  and  to  end  the  culvert  sequence. 


Field 

Variable 

Value 

Description 

0 

ID 

CC 

Record  identification. 

1 

DIA 

+ 

Culvert  diameter  (ft). 

2 

ZIN 

+ 

Upstream  invert  elevation  (ft). 

3 

ZOUT 

+ 

Downstream  invert  elevation  (ft). 

4 

CLEN 

+ 

Barrel  length  (ft). 

5 

CN 

+ 

Manning's  n  value. 

6 

ICCOEFF 

+ 

UNET  Index  No.  for  culvert  loss  coefficient  type. 
(Appendix  B,  Page  59) 

7 

IQDIR 

0 

Flow  can  go  in  both  directions  through  the 
culvert. 

+1 

Flow  can  only  go  in  the  positive  flow  direction. 

-1 

Flow  can  only  go  in  the  negative  flow  direction. 

8-10 

Blank  fields. 
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Culvert  Loss  Types 


Characteristics 


14  j  Rectangular  Box 


21  I  Rectangular  Box  3/4* 
i  Chamfers 


90  deg.  head  wall  with  3/4in. 
chamfers 


90  deg.  headwall  with  45  deg. 
bevels 


90  deg.  headwall  with  33.7  deg. 
bevels 


3/4"  chamfers;  45  deg.  skewed 
headwall 


3/4"  chamfers;  30  deg.  skewed 
headwall 


3/4"  chamfers;  15  deg.  skewed 
headwall 


45  deg.  bevels;  10-45  deg. 
skewed  headwall 


45  deg.  non-offset  wingwall 
flares 


18.4  deg.  non-offset  wingwall 
flares 
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Culvert  Records 


Culvert  Loss  Types  (Continued) 


UNET 
Index  No. 


Inlet 

Characteristics 


Entrance 

Loss 

Coef. 


23  j  Rectangular  Box  3/4“ 
i  Chamfers 


24  i  Rectangular  Box  Top 
I  Bevels 


25 


26 


27  i  CM  Boxes 


18.4  deg.  non-offset  wingwall 
45  deg.  wingwall  flares-offset 


9.9..9®£'..t].®®9)?®!! . 

Thick  waHproj^^^^^^^^  . 

Thin  wall 


12 

3 

13 

1 

13 

2 

13 

3 

16-19 

1 

16-19 

2 

16-19 

3 

29 

1 

29 

2 

29 

3 

30 

1 

30 

2 

30 

3 

34 

1 

. 3±^ 

2 

34 

3 

35 

1 

_ 35^^ 

2 

35 

3 

36 

1 

36 

1 

36 

2 
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Culvert  Loss  Types  (Continued) 


UNET 
Index  No. 


Culvert 


Inlet 

Characteristics 


Entrance 

Loss 

Coef. 


45  I  Arch  CM 


46 


47 


48  i  Circular 


tapered-less  favorable 
s 


Side  tapered>more  favorable 


56  j  Rectangular  Concrete  |  Side  tapered-less  favorable 


Slope  tapered-more  favorable 


40-42 

1 

40-42 

2 

40-42 

3 

54 

1 

54 

2 

55 

1 

55 

2 

55 

3 

56 

1 

57 

1 

57  i 

2 

58 

1 

58 

1 
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CL 


Culvert  Records 


CL  Record  -  Limits  of  Culvert  Rating  Tables  -  (Optional  Record) 

The  CL  Record  is  used  to  define  tailwater  and  pool  (headwater)  elevations 
required  to  compute  a  series  of  rating  curves  used  to  solve  for  culvert  flow.  The  CL 
Record  is  placed  at  the  end  of  each  culvert  sequence.  If  the  CL  Record  is  blank, 
CSECT  determines  the  limits  from  the  upstream  cross  section.  However,  the  user  must 
ensure  that  the  cross  section  table  limits  encompass  the  anticipated  maximum  and 
minimum  water  surface  elevation. 


0 

ID 

CL 

Record  identification. 

1 

NTW 

+ 

Number  of  tailwater  elevations  (maximum  of  50). 

0 

Default  of  50  is  used. 

2 

NP 

+ 

Number  of  pool  elevations  (maximum  of  50). 

0 

Default  of  50  is  used. 

3 

ZTW1 

+ 

Starting  tailwater  elevation  (ft). 

0 

D/S  invert  plus  0.15*RISE. 

4 

ZTW2 

+ 

Final  tailwater  elevation  (ft). 

0 

From  U/S  cross  section. 

5 

ZHW1 

+ 

Starting  headwater  elevation  (ft). 

0 

U/S  invert  plus  0.15*RISE. 

6 

ZHW2 

+ 

Final  headwater  elevation  (ft). 

0 

From  U/S  cross  section. 

7-10 

Blank  fields. 
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Rl 


Rl  Record  -  Culvert  Riser  -  (Optional  Record) 

The  Rl  Record  defines  a  riser  discharge  structure.  The  structure  consists  of  from 
1  to  5  riser  pipes  and  an  optional  overflow  weir  which  is  defined  by  a  WD  Record.  The 
data  input  for  the  structure  is  ended  with  the  RL  Record. 


Field 

Variable 

Value 

Description 

0 

ID 

Rl 

Record  identification. 

1 

DIA 

+ 

Culvert  diameter  in  feet. 

2 

ZIN 

Upstream  invert  elevation. 

3 

ZOUT 

+ 

Downstream  invert  elevation. 

4 

GLEN 

Barrel  length  in  feet. 

5 

CN 

+ 

Manning's  n  value. 

6 

ICCOEF 

+ 

UNET  Index  No.  for  culvert  loss  coefficient  type, 
(pp.  46-48). 

7 

CRISER 

+ 

Riser  discharge  coefficient. 

8 

ZRISER 

+ 

Elevation  of  the  culvert  riser. 

9 

RISERL 

+ 

Perimeter  of  Riser  opening  (used  as  a  weir 
length). 
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Culvert  Records 


BD 

BD  Record  -  Bleeder  Structure  for  a  Riser  -  (Optional  Record) 

The  BD  Record  associates  a  bleeder  with  a  riser  pipe,  Rl  Record.  The  BD  Record 
should  be  placed  immediately  before  the  Rl  Record. 


Field 

Variable 

Value 

Description 

0 

ID 

BD 

Record  Identification. 

1 

IBLTYP 

1 

Triangular  notch. 

2 

Rectangular  notch. 

3 

Triangle. 

4 

Rectangle. 

5 

Circle. 

2 

ZBLINV 

+ 

Invert  of  Bleeder. 

3 

HBL 

+ 

Hieght  of  Bleeder. 

4 

WBL 

+ 

Width  of  Bleeder. 

5 

CBL 

+ 

Bleeder  discharge  coefficient. 
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RL 


RL  Record  -  Riser  Limits  -  (Optional  Record) 

The  RL  Record  defines  the  limits  of  the  family  of  free  and  submerged  rating  curves 
for  a  riser.  This  record  is  required  when  using  an  Rl  Record. 


Variable 

Value 

Description 

T” 

ID 

RL 

Record  identification. 

1 

NTW 

+ 

Number  of  tailwater  elevations. 

0 

Assume  50. 

2 

NP 

+ 

Number  of  pool  elevations. 

0 

Assume  50. 

3 

ZTW1 

+ 

Starting  tailwater  elevation. 

4 

ZTW2 

+ 

Final  tailwater  elevation. 

5 

ZHW1 

+ 

Starting  headwater  elevation. 

6 

ZHW2 

+ 

Final  headwater  elevation. 
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Culvert  Records 


Dl 

PI  Record  > 

Drop  Inlet  for  Culvert 

-  (Optional  Record) 

The  Dl  Record  inserts  a  drop  inlet  structure  before  a  culvert.  The  Dl  Record,  if 
used,  must  precede  a  CC,  CB,  or  CA  Record. 

Field 

Variable 

Value 

Description 

0 

ID 

Dl 

Record  identifier. 

1 

ZDI 

Elevation  of  crest  of  drop  inlet. 

2 

WDI 

+ 

Width  of  drop  inlet. 

3 

GDI 

+ 

Wier  Coefficient  of  drop  Inlet  structure  (usually  3  - 
4). 

4 

EXDI 

+ 

Exponent  for  drop  inlet  equation  (usually  1 .5). 

Uncontrolled  Weir  for  Spillways,  Bridges,  and  Culverts _ Appendix  B  -  CSECT  Input  Data  Description 

WD 

WD  Record  -  Uncontrolled  Overflow  Weirs  -  (Optional  Record) 

The  WD  Record  is  used  to  define  up  to  25  broad-crested  weir  sections  associated 
with  spiiiway  (SP,  LA,  LS),  navigation  dam  (ND),  Bridge  (BR),  and  culvert  (CA,  CB,  CC, 
Rl)  internal  boundary  conditions.  The  WD  Record  should  immediately  follow  the 
appropriate  set  of  the  above  records  in  the  CSECT  input  fiie. 


Field 

Variable 

Value 

Description 

0 

ID 

WD 

Record  identification. 

1 

NWEIR 

+ 

Number  of  weir  segments  (maximum  of  25). 

2 

CWEIR 

+ 

Broad-crested  weir  flow  coefficient  (0.0  -  4.0).* 

3,5, 7,9 

ZWEIR 

+ 

Elevation  at  crest  of  weir  section  (ft).  Start  with 
the  iowest  weir  elevation. 

4,6,8,10 

WEIRL 

. + . 

Incremental  width  of  each  weir  segment  (ft). 

*Note:  For  fiow  over  a  typical  bridge  deck,  a  weir  coefficient  of  2.6  is 

recommended.  A  weir  coefficient  of  3.0  is  recommended  for  flow  over 
elevated  roadway  approach  embankments.  A  good  reference  for  weir 
coefficients  is  Braterand  King,  1976.  Handbook  of  Hydraulics, 
McGraw-Hill. 
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Special  Connection  Record 


SC 

sc  Record -  Special  Connections  Between  Storage  Areas  and  Channels  to  Storage 
Areas  -  (Optional  Rec.) 

The  SC  Record  redefines  the  connections  for  the  next  SP,  Rl,  CC,  CA,  CB,  and 
RW  Records.  The  SC  Record  allows  a  spillway,  a  culvert,  or  a  weir  to  be  placed 
between  two  storage  areas.  Note  that  the  numbers  of  the  storage  areas  must  be 
entered  as  negative  numbers.  The  SC  Record  can  also  be  used  to  connect  a  spillway, 
culvert,  or  weir  from  a  cross  section  to  a  storage  area.  The  SC  Record  must  be  placed 
immediately  after  the  cross  section  that  is  to  be  connected  to  the  storage  area. 


Field  Variable  Value _ Description 


0 

ID 

SC 

Record  identification. 

1 

ISA1 

0 

Upstream  cross  section  will  be  used. 

- 

Storage  area  number  to  connect  from. 

2 

ISA2 

- 

Storage  area  number  to  connect  to. 

Ratinp  Curve  Records 
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RF 


RF  Record  -  Free  Flow  Rating  Curves  -  (Optional  Record) 

Some  hydraulic  structures  may  need  to  be  modeled  by  one  or  more  rating  curves 
which  describe  unsubmerged  flow,  submerged  flow,  or  some  combination  of  both. 

The  RF  Record  is  used  to  describe  a  free  flow  (unsubmerged)  rating  curve.  This 
curve  may  or  may  not  be  linked  with  a  family  of  submerged  flow  rating  curves  (RS 
Records),  where  each  submerged  curve  is  associated  with  a  unique  tailwater  elevation. 
A  maximum  of  fifty  points  are  allowed  per  curve. 


Field 

Variable 

Value 

Description 

0 

ID 

RF 

Record  identification. 

1 

NSTRY 

0 

Hydraulic  structure  is  described  by  free  flow  only. 

+ 

Number  of  submerged  flow  rating  curves  to  be 
used  with  the  free  flow  curve  (maximum  of  fifty). 
These  submerged  flow  cun/es  are  described  on 

RS  Records  immediately  following  the  RF  Record. 

2 

NPRCF 

+ 

Number  of  points  on  the  free  flow  rating  curve 
(maximum  of  fifty). 

3,5, 7,9 

ZHRCF(I) 

+ 

Headwater  elevation  (ft). 

4,6,8,10 

QRCF(I) 

+ 

Discharge  value  (ft^/s)  at  ZHRCF(I). 

Note  1 :  Points  5  through  50  should  be  entered  on  a  subsequent  RF  Records  in 

fields  1  through  1 0. 

Note  2:  When  an  RF  Record  is  read,  the  interpolated  cross  section  routine  is 

turned  off  at  the  current  input  cross  section.  This  is  done  to  avoid 
numerical  problems  related  to  having  interpolated  cross  sections  through 
an  internal  boundary  condition,  such  as  a  lateral  spillway.  If  interpolated 
cross  sections  are  being  used,  the  user  should  enter  another  XK  or  XI 
Record  downstream  of  the  internal  boundary  condition. 
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Ratinp  Curve  Records 


RS 

RS  Record  -  Submerged  Flow  Rating  Curves  -  (Optional  Record) 

The  RS  Record  is  used  to  define  submerged  flow  rating  curves.  RS  Records 
immediately  follow  RF  Records,  which  describe  a  free  flow  rating  curve.  CSECT  is 
dimensioned  for  fifty  submerged  rating  curves,  each  one  having  a  maximum  of  fifty 
elevation-discharge  points.  Refer  to  the  input  description  for  the  RF  Record  for  details 
on  the  relation  between  free  and  submerged  rating  curves. 


Field 

Variable 

Value 

Description 

0 

ID 

RS 

Record  identification. 

1 

NPSUB 

+ 

Number  of  points  on  the  rating  curve  (maximum  of 
fifty). 

2 

ZTSUB 

+ 

Tailwater  elevation  (ft). 

3, 5,7,9 

ZHSUB(I) 

+ 

Headwater  elevation  (ft). 

4,6,8,10 

QSUB(I) 

+ 

Discharge  value  (ft7s)  at  ZHSUB(I). 

Note;  Points  5  through  50  should  be  entered  on  a  subsequent  RS  Record  in 
fields  1  through  10.  The  number  of  submerged  rating  curves  following  a 
RF  Record  is  defined  by  NSTRY  in  field  1  on  the  RF  Record. 
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RW 


RW  Record  -  Weir  Flow  Rating  Curves  -  (Optional  Record) 

The  RW  Record  is  used  to  define  parameters  which  describe  a  cross-channel  weir 
as  a  internal  boundary  condition.  The  record  should  be  inserted  between  the  upstream 
and  downstream  cross  sections  which  bound  the  weir.  The  weir  is  assumed  to  coincide 
with  the  upstream  cross  section.  UNET  uses  a  weir  flow  equation  to  compute  a  free 
flow  rating  curve.  Up  to  four  overflow  sections  can  be  input  to  define  the  weir.  If  the 
computed  tailwater  elevation  is  greater  than  the  corresponding  rating  curve  elevation  for 
a  given  discharge  i.e.,  submerged  flow  conditions  exist,  the  rating  curve  is  released  and 
the  unsteady  flow  solution  continues  across  the  weir.  When  the  tailwater  elevation  falls 
below  the  rating  curve,  the  rating  curve  is  once  again  applied  in  the  computations. 


Field 

Variable 

Value 

Description 

0 

ID 

RW 

Record  identification. 

1 

NSEG 

Number  of  weir  segments. 

2 

CWEIR 

+ 

Weir  discharge  coefficient  (typical  range  is  2.5  - 
3.4) 

3, 5,7,9 

CWEIR 

+ 

Weir  crest  elevation  (ft). 

4,6,8,10 

WEIRL 

+ 

Weir  length  (ft). 
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Rating  Cun/e  Records 


RC 

RC  Record  -  Rating  curve  at  a  Cross  Section  (Optional  Record) 

Computes  a  free  flow  rating  curve  at  the  upstream  cross  section  assuming  the 
given  slope,  using  Manning's  Equation  or  a  weir  equation  assuming  piecewise  weir 
segments  between  the  cross  section  points.  For  Manning's  Equation,  the  area  and 
conveyance  properties  computed  by  CSECT  are  used.  If  the  cross  section  is  entered 
as  top  widths,  (the  TC,  TV,  etc.  cards),  the  weir  computation  will  not  work.  If  the 
computed  tailwater  stage  plus  the  swell  head  from  the  submerged  head  loss  factor  is 
greater  than  the  rating  curve  elevation,  the  rating  curve  is  released  and  the  solution  is 
continued  using  the  full  unsteady  flow  equations.  When  the  tailwater  stage  falls  below 
the  rating  curve,  the  rating  curve  once  again  controls. 


Field 

Variable 

Value 

Description 

0 

ID 

RC 

Record  identification. 

1 

SO 

+ 

Friction  slope  (ft/ft)  for  Manning’s  equation. 

0 

When  using  weir  equation. 

2 

CW 

+ 

Weir  coefficient  for  weir  equation. 

0 

When  using  Manning’s  equation. 

3 

ALPHA 

+ 

Submerged  head  loss  coefficient  (0.8  is 
reasonable). 

0 

When  using  Manning’s  equation. 

B-78 


Ratinp  Curve  Records 


Appendix  B  -  CSECT  Input  Data  Description 

LR 


LR  Record  -  Lateral  Outflow  Rating  Curve  -  (Optional  Record) 

The  LR  Record  is  used  to  enter  a  rating  curve  of  head  versus  discharge  to  define 
a  lateral  outflow  at  the  previous  cross  section  defined  on  an  X1  Record.  If  NLSCON  is 
left  blank  or  zero,  water  flows  out  of  the  system  and  is  lost  to  the  model.  Alternatively, 
an  input  cross  section  (ICS)  number  can  be  entered  to  define  a  connection  to  another 
reach.  An  example  use  of  the  LR  Record  is  where  gated  culverts  are  used  to  provide 
flow  out  of  a  channel  into  adjacent  lands  which  are  not  modeled  in  the  system. 


Field 

Variable 

Value 

Description 

0 

ID 

LR 

Record  identification. 

1 

NLSCON 

0 

Lateral  outflow  occurs  at  the  location  defined  by 
the  previous  X1  Record  in  the  input  file.  Water  is 
diverted  out  of  the  system  being  modeled. 

+ 

Input  cross  section  (ICS)  number  connected  to  the 

lateral  outflow.  Water  is  diverted  from  this  point  to 
another  within  the  model.  Do  not  attempt  to 
connect  a  lateral  outflow  to  a  storage  area. 


2 

NPRCF  + 

Number  of  points  on  the  rating  curve  (maximum  of 
50). 

3,5, 7,9 

ZHRCF(I)  + 

Head  (ft)  at  upstream  side  of  lateral  outflow. 

4,6,8,10 

QRCF(I)  + 

Discharge  (ft®/s)  at  ZHRCF(I). 

Note:  The  input  cross  section  number  (ICS)  is  determined  by  the  order  of  X1 
Records  in  the  input  file. 
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Family  of  Rating  Curves 


FA 

FA  Record  -  Use  of  Exponential  Equations  Rather  than  a  Family  of  Rating  Curves  - 
(Optional  Record) 

The  FA  Record  directs  that  exponential  equations  rather  than  a  family  of  rating 
curves  be  used  for  bridge  and  culvert  interior  boundary  conditions.  The  FA  Record 
should  be  placed  before  the  culvert  or  bridge  records.  If  the  FA  Record  is  not  used, 
the  culvert  and  bridge  routines  use  a  family  of  rating  curves  to  calculate  the  head  loss 
for  submerged  and  free  flow  situations.  The  family  of  rating  curves  should  normally  be 
used.  Commonly,  the  exponential  curve  fit  exhibits  large  errors  for  situations,  such  as 
at  multiple  culverts,  where  the  inlet  elevations  are  substantially  different. 

Field  Variable  Value  Description 

0  ID  FA  Record  Identification 

1  LFAMILYRC  ON  Start  using  the  family  of  rating  curves  (default). 

OFF  Start  using  exponential  equations  (not 
_ recommended). _ _ 


Family  of  Ratinp  Curves 
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CO 


CO  Record  -  Combine  Families  of  Rating  Curves 

The  CO  Record  directs  that  families  of  rating  curves  be  combined  together. 
Families  of  rating  curves  which  are  in  close  proximity  can  oscillate  one  against  the 
other.  An  exampie  is  two  sequential  culverts  that  span  a  dual  lane  highway.  To 
eliminate  the  oscillations,  the  CO  card  directs  that  the  families  of  rating  curves  be 
combined  into  a  single  set  into  a  single  set.  The  combination  is  started  at  the 
"COMBINE  START"  and  ended  at  "COMBINE  END,"  which  are  placed  before  the 
upstream  bounding  cross  section  and  after  the  downstream  bounding  cross  section, 
respectively.  All  of  the  interior  cross  sections  (between  the  bounding  cross  sections) 
are  included  in  the  rating  cun/es;  therefore,  these  cross  sections  are  not  a  part  of  the 
computations.  An  HY  Record  within  the  interior  cross  sections  will  produce 
unpredictable  results.  The  parameters  ON  and  OFF  are  entered  in  free  format;  they 
can  appear  anywhere  in  the  card. 


Field 

Variable 

Value 

Description 

0 

ID 

CO 

Card  identifier. 

1 

CCO 

START 

Combine  rating  curves. 

OFF 

Do  not  combine  rating  curves. 

Example 

For  example  consider  the  following  culvert  crossing  for  a  dual  lane  highway: 


X1  1 
GR 

COMBINE  ON 
X1  2 
HY 
GR 

*  FIRST  CULVERT 

CC 

CC 

WD 

CL 

X1  3 


The  two  culverts  and  cross  sections  3,4, 
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Family  of  Rating  Curves 


CO  (Cont.) 

GR  and  5  are  combined  into  a  single  set  of  rating 

X1  4  curves  between  cross  sections  2  and  6. 

X1  5 

GR 

*  SECOND  CULVERT 

CB 

WD 

CL 

X1  6 

HY 

GR 

COMBINE  OFF 
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PD  Record  -  Pumped  Diversion  -  (Optional  Record) 

The  pumped  diversion  diverts  water  from  one  channel  or  storage  area  and  inserts 
the  water  into  another  channel  or  storage  area.  Up  to  10  pumps  may  be  specified. 
Pumps  should  be  entered  by  increasing  starting  elevation. 


Field  Variable 


Value  Description 


PD  Record  identification. 


IRCH1 


Reach  from  which  water  will  be  diverted. 


For  Storage  Areas. 


RMILE1 


River  mile  from  which  water  will  be  diverted. 


Storage  Area  Number  to  divert  water  from. 


IRCH2 


Reach  that  will  receive  water. 


For  Storage  Areas. 


RMILE2 


River  mile  that  will  receive  water. 


NPUMP 


ZPUMP(I) 

ZPUMPO(I) 

QPUMP(I) 

ZPUMP(2) 

ZPUMPO(2) 

QPUMP(2) 


Storage  Area  Number  to  divert  water  to. 
Number  of  pumps. 

Elevation  when  pump  is  stopped. 

Elevation  when  pump  is  started. 

Pump  capacity. 

Elevation  when  second  pump  is  stopped. 

Elevation  when  second  pump  is  started. 

Capacity  of  second  pump.  This  value  is  placed 
on  a  second  PD  Record. 


etc..  etc.. 


Continue  in  fields  of  subsequent  PD  Records 
for  up  to  10  pumps. 
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Closed  Conduits 


TN 

TN  Record  -  Circular  Tunnel 

The  TN  Record  defines  the  basic  circular  tunnel  geometry  and  the  associated 
Darcy-Weisbach  roughness  parameters.  Under  low  flow,  a  circular  section  has  a  large 
width  to  depth  ratio.  Hence,  negative  depths  can  be  computed.  The  pilot  channel 
redefines  the  shape  of  the  tunnel  invert  into  a  rectangular  shape  which  has  better 
computation  properties.  The  total  area  and  conveyance  are  unaffected  above  0.25  of 
the  total  depth. 


Field 

Variable 

Value 

Description 

0 

ID 

TN 

Record  identifier. 

1 

DIA 

+ 

Tunnel  diameter. 

2 

ZMN 

+ 

Tunnel  invert  elevation. 

0 

Use  SLOPE  to  calculate  ZMN. 

3 

BULKI 

+ 

Bulk  modulus  for  water,  usually,  43.2  x  10®  lbs  per  ft^. 

0 

Assume  43.2  x  1 0®  lbs  per  ft^. 

4 

DZ 

+ 

Slope  in  ft.  per  mile.  Compute  ZMN  from  the 
minimum  elevation  of  the  past  cross  section,  the 
slope,  and  the  distance. 

0 

Use  ZMN. 

5 

ROUGH 

+ 

Darcy-Weisbach  grain  roughness  in  feet. 

0 

Use  current  Manning's  n  value. 

6 

PPCH 

+ 

Fraction  of  the  total  tunnel  area  to  be  reallocated  into 
a  pilot  channel. 

7 

HPCH 

+ 

Depth  of  the  pilot  channel. 

8 

PCHN 

+ 

Manning's  n  value  for  pilot  channel. 

9 

Not  used. 

10 

NTUNNEL 

+ 

Number  of  parallel  tunnels. 
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TB 


TB  Record  -  Rectangular  Tunnel 

The  TB  Record  defines  the  basic  rectangular  tunnel  geometry  and  the  associated 
Darcy-Weisbach  roughness  parameters.  Under  low  flow,  a  rectangular  section  has  a 
large  width  to  depth  ratio.  Hence,  negative  depths  can  be  computed.  The  pilot  channel 
redefines  the  shape  of  the  tunnel  invert  into  a  rectangular  shape  which  has  better 


computation  properties, 
the  total  depth. 

The  total  area  and  conveyance  are  unaffected  above  0.25  of 

Field 

Variable 

Value 

Description 

0 

ID 

TB 

Record  identifier. 

1 

HEIGHT 

+ 

Tunnel  height. 

2 

WIDTH 

+ 

Tunnel  width. 

3 

ZMN 

+ 

Tunnel  invert  elevation. 

0 

Use  SLOPE  to  calculate  ZMN. 

4 

BULKI 

+ 

Bulk  modulus  for  water,  usually,  43.2  x  10®  lbs  per  ft^. 

0 

Assume  43.2  x  1 0®  lbs  per  ft^. 

5 

DZ 

+ 

Slope  in  ft.  per  mile.  Compute  ZMN  from  the 
minimum  elevation  of  the  past  cross  section,  the 
slope,  and  the  distance. 

0 

Use  ZMN. 

6 

ROUGH 

+ 

Darcy-Weisbach  grain  roughness  (in  feet). 

0 

Use  current  Manning's  n  value. 

7 

PPCH 

+ 

Fraction  of  the  total  tunnel  area  to  be  reallocated  into 
a  pilot  channel. 

8 

HPCH 

+ 

Depth  of  the  pilot  channel. 

9 

PCHN 

+ 

Manning's  n  value  for  pilot  channel. 

10 

NTUNNEL 

+ 

Number  of  parallel  tunnels. 

B-85 


Appendix  B  -  CSECT  Input  Data  Description 

TE 


Alternative  Geometry  Specifications 


TE  Record  -  Elevations  for  Top  Width  Table 

Input  elevations  for  a  top  width  table.  A  maximum  of  twenty  elevations  can  be 
input. 


Field 

Variable 

Value 

Description 

0 

ID 

TE 

Record  identification. 

1,2, 

EL(I) 

+ 

Ground  elevation. 

3, ... 

TC 

-  Channel  Top  Widths 

Input  the  top  widths  of  the  channel.  The  top  widths  must  correspond  to  the 
elevations  on  the  TE  Record. 

Field 

Variable  Value 

Description 

0 

ID  TC 

Record  identification. 

1.2, 

3, ... 

TWCH(I)  + 

Channel  top  width. 

Alternative  Geometry  Specifications 
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TL 


TL  Record  -  Top  Width  of  Left  Overbank 

Input  top  widths  of  the  left  overbank.  The  top  widths  must  correspond  to  the 
elevations  on  the  TE  Record.  This  record  is  not  required  for  a  top  width  table. 

^_^ield  _yanable  Value  Description 

0  ID  TL  Record  Identification. 

1 , 2,  TWL(I)  +  Top  width  of  the  left  overbank. 

3. ... 


TR 


IR_Becord  -  Top  Width  of  Right  Overbank 

Input  top  widths  of  the  right  overbank.  The  top  widths  must  correspond  to  the 
elevations  on  the  TE  Record.  This  record  is  not  required  for  a  top  width  table. 

0  ID  TR  Record  identification. 

1 ,  2,  TWR(I)  +  Top  width  of  the  right  overbank. 

3. ... 
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Input  top  widths  of  the  storage  region.  The  top  widths  must  correspond  to  the 
elevations  on  the  TE  Record.  This  record  is  required  for  a  top  width  table  and  starts  the 
computation  of  cross-sectional  properties. 

0  ID  TS  Record  identification. 


1.2,  TWL(I)  + 
3. ... 


Top  width  of  the  left  overbank. 


Levee  Failures 

Appendix  B  -  CSECT  Input  Data  Description 

SF 

SF  Record  - 

Simple  Embankment  Failure 

The  SF  Record  defines  a  failure  of  an  embankment  using  a  linear  routing  failure 
algorithm  (simple  spillway).  The  SF  Record  may  be  between  a  reach  and  a  storage  cell 
and  between  two  cells.  Positive  flow  is  from  ICONN1  to  ICONN2.  The  input  fields 
define  the  connections,  the  elevation  when  the  embankment  is  to  fail,  the  invert 
elevation  of  the  breach,  the  linear  routing  factors,  and  the  type  of  failure.  The 
embankment  restores  itself  when  the  elevation  of  the  water  surface  falls  below  the 
invert  elevation  of  the  breach. 

Field 

Variable  Value 

Description 

0 

ID  SF 

Record  identification. 

1 

ICONN1  Blank 

Connect  to  the  last  cross  section  entered. 

- 

User  defined  storage  cell  number. 

2 

ICONN2  - 

User  defined  storage  cell  number. 

3 

ZFAIL  + 

Water  surface  elevation  when  the  embankment  is  to 
fail. 

4 

ZBRINV  + 

Elevation  of  the  breach  invert.  The  embankment  is 
repaired  when  the  water  surface  falls  below  ZBRINV. 

5 

CINLV  + 

Linear  routing  constant  for  flow  from  ICONN1  to 
ICONN2.  The  units  of  CINLV  are  fraction  of  the  total 
available  volume  per  hour. 

6 

COUTLV  + 

Linear  routing  constant  for  flow  from  ICONN2  to 
ICONN1 .  The  units  of  COUTLV  are  fraction  of  the 
total  available  volume  per  hour. 

7 

DTFAIL  + 

After  the  failure,  the  time  in  which  the  routing  constant 
will  increase  to  its  full  value.  By  increasing  the  routing 
constant  from  0  to  its  full  value  over  DTFAIL  hours, 
the  enlargement  of  a  breach  is  approximated. 

0 

Use  the  full  value  of  the  linear  routing  factor  at  the 
time  of  failure. 
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Levee  Failures 


SF  (Cont.) 

8  DTFILL  +  The  time  to  fill  the  interior  storage.  The  interior 

storage  of  the  connecting  cell  is  filled  in  DTFILL  hours 
after  failure.  DTFILL  cannot  be  specified  in 
conjunction  with  DTFAIL. 


0 


Use  linear  routing. 


Levee  Failures _ Appendix  B  -  CSECT  Input  Data  Description 


EF 

EF  Record  - 

Embankment  Failure 

The  EF  Record  inserts  an  embankment  failure  between  cross  sections;  between  a 
reach  and  a  storage  cell;  and  between  two  storage  cells.  The  flow  is  computed  using 
hydraulic  equations  -  a  weir  equation  for  open  channel  flow  and  an  orifice  equation  for 
flow  through  a  pipe  in  the  embankment.  The  hydraulic  calculation  is  in  contrast  to  the 

SF  Record  which  simulates  a  failure  using  a  simple  spillway  type  of  flow  calculation. 
When  the  embankment  failure  is  between  cross  sections,  the  EF  Record  must  be 
associated  with  an  in-line  internal  boundary  condition  such  as  a  spillway  (SP),  a  culvert 
crossing,  riser  pipe,  or  a  weir.  The  EF  Record  can  stand  alone  between  a  reach  and  a 
cell,  or  between  cells,  or  it  can  be  associated  with  another  interior  boundary  condition  in 
which  case  the  flow  is  added  to  the  flow  from  another  IBC. 

Field 

Variable 

Value 

Description 

0 

ID 

EF 

Record  identifier. 

1 

ZFAIL 

+ 

Elevation  when  the  embankment  failure  is  to 
commence. 

2 

ZBREACH 

+ 

Starting  elevation  of  the  pipe  through  the 
embankment. 

0 

For  overtopping  breaches. 

3 

ZBRINV 

+ 

Final  elevation  of  the  breach  invert. 

4 

ZCROWN 

+ 

Elevation  of  the  top  of  the  embankment. 

5 

COEF 

+ 

Orifice  flow  coefficient  for  a  piping  breach  (a 
typical  value  is  0.6). 

0 

For  overtopping  breaches. 

6 

CWEF 

+ 

Weir  flow  coefficient  for  an  overtopping  breach. 

7 

BRWIDTH 

+ 

Maximum  width  of  the  breach  invert. 

0 

For  a  triangular  breach. 

8 

DTFAIL 

+ 

Time  in  hours  for  a  breach  to  enlarge  to  its 
maximum  width  (BRWIDTH)  and  its  final  invert 
elevation  (ZBRINV). 
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EF  (Cont.) 

9  EFSS  +  Vertical  rise  per  unit  of  horizontal  distance  (slope  of 

sides  of  breach),  (vertical/horizontal) 


0 


Vertical  side  slopes. 


Include  Files 
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INCLUDE  FILES 

When  a  large  number  of  levee  systems  are  connected  to  a  river  model  (say  ten  or 
more),  the  data  that  describe  the  cell  definitions  and  levee  connections  may  interfere 
with  the  readability  of  the  cross  section  geometry.  The  UNET  system  incorporates  the 
use  of  include  files  to  ease  this  data  situation.  After  cross  section  geometry  has  been 
entered,  include  files  can  be  specified  via  the  IS  Record.  The  include  files  provide  the 
following  functions: 

•  Define  cells  using  the  RE,  SA,  SV  (optional)  and  HS  Records. 

•  Define  simple  levee  failures;  RE  and  SF  Records. 

•  Define  embankment  failures  using  RE,  SC,  and  EF  Records. 

•  Define  culvert  cell  connections  using  RE,  SC,  CC,  CB,  CE,  CA,  WD  and  CL. 

•  Define  riser  pipe  connections  using  RE,  SC,  Rl,  WD,  and  RL  Records. 

•  Define  gated  spillway  connections  using  RE,  SC,  SP,  and  WD  Records. 

Two  notes  regarding  the  above  input  data.  The  RE  Record  defines  the  reach 
number  and  the  cross  section  river  mile  (SECNAM  on  the  X1  Record)  that  the  cell  or 
connection  is  attached  to.  An  RE  Record  must  precede  every  cell  definition  and 
connection.  The  SC  (special  connection)  Record  defines  the  connection  from  reach  to 
cell  and  from  cell  to  cell  for  different  types  of  flow  connections. 

Table  B-1  shows  the  include  file  that  defines  the  Columbia  and  Harrisonville 
Levees.  The  levee  storage  is  defined  on  the  SA  Record  and  the  levee  breaches  on  the 
SF  Records.  The  RE  Record  defines  the  reach  and  cross  section  location  of  the  levee 
and  storage  connections. 

As  shown  on  Table  B-2,  the  IS  Records  are  located  at  the  end  of  the  cross  section 
(.CS)  file,  after  the  reach  and  cross  section  data.  The  sole  parameter  on  the  IS  Record 
is  the  name  of  the  include  file. 

NOTE:  Include  files  must  have  the  extension  .INC. 
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Table  B-1 

Contents  of  the  Include  File  MISSLV.INC  referred  to  in  Table  B-2 


******** ************ 

* 

*  Coluinbia 

* 

RE  7  166.00 

SA  -112  13560.  395.10 

HS  Columbia  -  Cell  -112 
* 

* 

RE  7  165.00 

SF  -112  418.00  410.00  .150  .150  .0  30.0  .0 

* 

* 

RE  9  156.50 

SF  -112  418.00  410.00  .050  .050 

* 

*  Connection  between  Columbia  and  Harrisonville 

RE  9  156.50 

SF  -112  -113  410  390  .10  .10  24 

* 


******************** 

* 

*  Harrisonville,  FT.  Chartres,  and  Stringtown 

* 

RE  9  156.30 

SA  -113  46700.  390.10 

HS  Harrisonville  -  Cell  -113 
* 

* 

RE  9  130.90 

SF  -113  402.00  379.29  .060  .060  24  .0  .0 

* 

* 
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Table  B-2 

Contents  of  the  Include  File  MISSLV.INC  referred  to  in  Table  B-2 


XI 

0.0 

77 

1582 

4250 

GR 

336 

0 

335 

56 

350 

56 

350 

76 

335 

76 

GR 

330 

280 

350 

280 

350 

300 

330 

300 

323 

500 

GR 

350 

504 

350 

524 

320 

524 

320 

600 

315 

728 

GR 

350 

728 

350 

748 

315 

748 

316 

952 

350 

952 

GR 

350 

972 

320 

972 

320 

1176 

350 

1176 

350 

1196 

GR 

320 

1196 

315 

1561 

350 

1561 

350 

1581 

315 

1582 

GR 

290 

1950 

288 

2011 

350 

2011 

350 

2031 

288 

2031 

GR 

284 

2200 

264 

2300 

263 

2461 

350 

2461 

350 

2481 

GR 

262 

2481 

265 

2650 

260 

2850 

272 

3161 

350 

3161 

GR 

350 

3181 

272 

3181 

270 

3611 

350 

3611 

350 

3631 

GR 

270 

3631 

275 

4000 

280 

4061 

350 

4061 

350 

4081 

GR 

290 

4081 

320 

4250 

320 

4446 

350 

4446 

350 

4466 

GR 

320 

4466 

320 

4502 

350 

4502 

350 

4522 

320 

4522 

GR 

320 

4726 

350 

4726 

350 

4746 

320 

4746 

320 

4900 

GR 

318 

4950 

350 

4950 

350 

4970 

317 

4970 

310 

5400 

GR 

327 

5450 

336 

5451 

DB 

•k 


*  INCLUDE  FILE  FOR  MISSOURI  RIVER  CROSSOVER 

* 

IS  CROSS. INC 


*  ILLINOIS  RIVER  LEVEES 

* 

IS  ILRLV.INC 


*  MISSOURI  RIVER  LEVEES 

* 

IS  MOLV2.INC 


*  MISSISSIPPI  RIVER  LEVEE  SYSTEMS 

* 

IS  MXSSLV.XNC 

EJ 
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Job  Control  Records 

Title  Lines  (required)  and  Comments  . C-7 

Job  Control  (required)  . C-8 

Individually  Defined  Parameters  . C-10 

Time  Window . C-1 3 

Time  Increment  . C-1 4 

End  of  Job  . C-1 5 

DSS  Interface  Control 

Open  DSS  File . C-1 6 

Close  DSS  File . C-1 7 

Write  Hydrographs  to  DSS  . C-1 8 

Initial  Conditions 

Initial  Flow  Distribution . C-1 9 

Initial  Storage  Area  Elevation . C-20 

Read  Initial  Conditions  File  . C-21 

Upstream  Boundary  Conditions 

Upstream  Flow  or  Stage  Hydrograph  . C-22 

Upstream  Stage  and  Flow  Hydrograph . C-24 

Critical  Upstream  Boundary . C-25 

Downstream  Boundary  Conditions 

Downstream  Flow  Hydrograph  . C-26 

Downstream  Stage  Hydrograph  . C-27 

Downstream  Stage  and  Flow  Hydrograph . C-28 

Downstream  Rating  Curve . C-29 

Downstream  Manning's  Equation  . C-30 

Pump  Station  as  a  Downstream  Boundary  Condition . C-31 

Internal  Boundary  Conditions 

Lateral  Inflow  Hydrograph  . C-32 

Uniform  Lateral  Inflow  Hydrograph  . C-34 

Critical  Lateral  Inflow . C-36 

Interflow  between  a  Groundwater  Reservoir  and  a  River . C-37 

Time  Series  of  Gate  Openings  . C-38 

Elevation  Controlled  Gate  . C-39 

Observed  Stage  Internal  Boundary  Condition . C-40 

Observed  Stage  and  Flow  Internal  Boundary  Condition . C-41 

Calibration  Options 

Conveyance  Change  Factors  . C-43 

Discharge  -  Conveyance  Relation . C-44 
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General  Description  of  Input  Data 

The  input  file  which  controls  the  UNET  program  consists  of  several  data  types. 
These  data  define  job  control  parameters,  initial  and  boundary  conditions,  simulation 
and  forecast  times,  hydrograph  specifications,  and  many  other  physical  conditions 
specific  to  each  application.  Each  data  type  consists  of  two  parts;  a  leading  command 
line  which  must  be  left  justified,  and  parameter  variables  on  following  line(s)  entered  in 
free  format  (a  comma  or  blanks  between  data  values). 

Certain  significant  characters  must  appear  in  the  UNET  command  lines.  In  the 
following  documentation,  these  characters  are  underlined.  Additional  text  further 
identifying  the  data  type  may  appear  anywhere  in  the  remainder  of  the  command  line. 
First  time  users  should  enter  the  command  lines  as  shown.  With  experience,  editing 
can  be  added  to  provide  improved  documentation  and  appearance  of  data  files. 
Additional  comment  lines  may  be  added  by  entering  an  asterisk  (*)  in  the  first  column  of 
the  line. 

Except  as  noted,  data  sets  do  not  have  to  be  entered  in  any  particular  order.  All 
data  sets  are  not  required  for  each  model  run.  Only  the  titles,  job  control,  initial  and 
boundary  conditions,  and  end  job  sets  are  required.  Other  sets  are  optional  and  should 
be  included  as  required. 

Appendix  D  presents  example  problems  which  illustrate  the  use  of  many  of  the 
basic  input  data  types.  It  is  suggested  that  the  extensions  .BC  and  .BOO  be  used  when 
naming  the  input  and  output  files  for  UNET. 

Changes  from  UNET  User’s  Manual  Ver.  2.1,  May  1993 


Changed  Records: 

Job  Control .  C-8 

Individually  Defined  Parameters .  C-10 

Time  Window .  C-13 

Open  DSS  File .  C-16 

Write  Hydrographs  to  DSS .  C-18 

Initial  Flow  Distribution  .  C-19 

Initial  Storage  Area  Elevation .  C-20 

Read  Initial  Conditions  File .  C-21 

Critical  Upstream  Boundary .  C-25 

Time  Series  of  Gate  Openings .  C-38 

Discharge  -  Conveyance  Relation  .  C-44 

New  Records: 

Upstream  Flow  or  Stage  Hydrograph .  C-22 

Downstream  Stage  and  Flow  Hydrograph  .  C-28 

Pump  Station  as  a  Downstream  Boundary  Condition .  C-31 

Interflow  between  a  Groundwater  Reservoir  and  a  River .  C-37 

Elevation  Controlled  Gate .  C-39 

Observed  Stage  and  Flow  Internal  Boundary  Condition .  C-41 
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Title  Lines  (required)  and  Comments 

Both  title  and  comment  lines  are  denoted  by  an  asterisk  (*)  in  column  1 .  UNET 
requires  that  the  first  three  lines  of  the  input  file  be  title  lines.  Title  lines  are  used  by 
various  routines  for  identification  and  documentation  purposes.  Comment  lines  can 
appear  anywhere  else  in  the  file  (except  within  a  block  of  data).  Title  and  comment 
lines  may  contain  any  alphanumeric  text  up  to  80  characters  in  length,  including  the 
asterisk  in  column  1 . 

The  first  and  second  title  lines  are  used  as  headings  in  the  UNET  output  file.  The 
third  line  can  be  used  to  control  the  F  part  of  DSS  pathnames  for  hydrographs  and 
profiles  written  by  the  TABLE  program.  If  the  capitalized  string  SIMULATION  appears 
anywhere  on  the  line,  the  F  part  of  the  DSS  pathname  will  be  written  as  the  string 
COMPUTED.  In  all  other  cases,  the  F  part  will  be  written  as  the  first  20  characters  of 
the  line. 


Example: 

*  Project  Title 

*  Username,  Location,  Date,  Filename 

*  SIMULATION  (limited  to  20  characters  for  the  F  part  of  the  HEC-DSS  pathname) 
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Job  Control  (required) 

This  data  record  directs  the  flow  and  numerics  of  the  program.  Depending  on  the 
computer  system,  the  logical  constants  T  and  F  may  or  may  not  need  to  be  surrounded 
by  periods.  On  DOS  PC’s,  the  characters  do  not  need  to  be  enclosed,  but  the  periods 
are  accepted.  On  Cray  computers  the  periods  are  required. 

Command  Line: 

JOB  CONTROL 

Variables: 

IPRINT,  PZMX,  DT,  PT,  TSP,  TLEVEE,  THETA,  STORGE, 
DPRINT,  TWIC,  TABINC 

Variable 

Value 

Description 

iprTnt 

T 

Print  initial  conditions  (default  =  TRUE). 

F 

Do  not  print  initial  conditions. 

PZMX 

T 

Calculate  maximum  water  surface  profile  and  write 
results  to  HEC-DSS  (default  =  TRUE). 

F 

Do  not  compute  water  surface  profile. 

DT 

+ 

Time  step  size  in  hours  (defauit  =  1).  This  can  also 
be  specified  as  an  HEC-DSS  interval;  i.e.,  1MIN, 
10MIN,  1HOUR,  6HOUR,  etc.  DT  must  be  a  multiple 
of  minutes  and  less  than  or  equal  to  24  hours. 

TSP 

0 

Not  used.  Enter  zero. 

PT 

+ 

Time  interval  of  instantaneous  flow  and  elevation 
profiles  to  be  written  to  DSS  (Time  interval  in  hours). 

- 

No  profiles  are  written  to  DSS  (default). 

TLEVEE 

T 

Levee  routines  are  enabled  for  the  computations 
(default). 

F 

Disable  levee  routines. 

THETA 

0.6-1 .0  Implicit  weighting  factor  (default  =  1 , 0.6  is 

recommended,  see  Note  1). 

STORGE 

T 

Storage  accounting  routines  have  not  been 
developed. 

F 

No  storage  accounting  (default). 
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Job  Control  (continued) 


Variable  Value  Description 


□PRINT  T 

At  each  time  step,  write  flow  and  stage  data  at 
hydrograph  nodes  to  the  UNET  output  file.  These 
nodes  are  defined  by  HY  Records  in  the  CSECT 
geometry  input  file  (default  =  T).  Also  write  status  of 
spillway  structures.  This  option  can  make  the  output 
file  quite  large,  and  should  be  turned  off  once  an 
application  has  been  debugged. 

F 

Do  not  write  data  to  output  file. 

TWIG  + 

Time,  in  hours,  after  the  beginning  of  the  simulation  at 
which  flow  and  stage  at  each  node  will  be  written  to  a 
file  of  initial  conditions  (INTL.CON)  to  be  used  as  a 
"hot  start"  file  in  a  later  simulation  (default  =  -1).  See 
READ  INITIAL  CONDITIONS  Record. 

-1 

Do  not  write  initial  conditions  file. 

TABINC  Alpha 

Specify  the  DSS  time  interval  to  be  used  for 
computed  flow  and  stage  hydrographs.  Only  valid 

DSS  time  intervals  may  be  selected  (see  note  2 
below).  TABINC  is  entered  as  an  alphanumeric 
(character)  string  i.e.,  15MIN,  3HOUR,  1DAY, 

1WEEK,  1MON,  1YEAR,  etc.  The  hydrographs  will 
also  be  appended  to  the  UNET  output  file  in  tabular 
format.  TABINC  must  be  a  multiple  of  DT  (see 
previous  page). 

-Alpha 

If  the  time  interval  is  input  as  a  negative  value,  no 
data  will  be  appended  to  the  UNET  output  file. 

Example: 

JOB  CONTROL 

T  T  10MIN  4  6  F  0.6  F  T  -1  30MIN 

Notes: 

(1 )  Users  should  begin  an  application  using  a  THETA  value  of  1 .0  for  maximum 
stability.  When  geometric  and  other  problems  have  been  resolved,  THETA  can  be 
reduced  towards  0.6  (the  maximum  accuracy  value,  however,  solutions  may  be 
susceptible  to  instablities). 

(2)  Only  the  following  time  intervals  are  considered  valid  by  the  DSS. 

1MIN,  2MIN,  3MIN,  4MIN,  5MIN,  10MIN,  15MIN,  20MIN,  30MIN  (Block  length  =  1  day) 
1HOUR,  2HOUR,  3HOUR,  4HOUR,  6HOUR,  8HOUR,  12HOUR  (Block  length  =  1  mo.) 

1  DAY  (Block  length  =  1  year) 

1WEEK,  1MON  (Block  length  =  1  decade) 
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Individually  defined  parameters  are  used  to  define  specific  variables  used  in  the 
computations.  One  parameter  is  used  per  line  and  is  identified  by  a  keyword  followed 
by  an  equals  sign  For  example,  the  line:  ZERO=100.0,  indicates  that  the  next 
stage  hydrograph  in  the  input  fiie  will  have  a  gage  zero  elevation  of  100  feet. 

Parameter  Value  Description 

TING  +  Specifies  the  time  increment  (in  hours)  of  the 

hydrograph  to  be  input  to  UNET.  TING  should  be 
specified  in  every  UNET  input  file.  If  it  is  not,  TING 
defaults  to  DT,  the  computational  time  interval.  Data 
in  DSS  files  are  often  stored  at  very  short  time 
intervals  i.e.,  1  hour,  2  hours,  etc.  UNET  has  a 
limited  number  of  ordinates  per  hydrograph,  MGRD 
(refer  to  the  RDSS  output  file  under  the  heading 
"PRGGRAM  DIMENSIGNS").  The  number  of  periods 
in  the  TIME  WINDGW  multiplied  by  TING  should  be 
less  than  MGRD.  If  MGRD  is  exceeded  and  the  input 
hydrographs  are  read  from  DSS,  UNET  will  subdivide 
the  TIME  WINDGW  and  perform  the  computations  for 
each  subdivision  sequentially.  The  DSS  output  will 
contain  results  for  the  full  TIME  WINDGW,  but  the 
output  file  will  only  reflect  the  last  subdivision. 

QMIN  +  Minimum  flow  value.  Apply  a  minimum  flow  limit  to 

input  hydrographs,  (default  =  0).  Remains  in  effect 
until  next  QMIN=  record. 

QMULT  +  or  -  Multiply  input  flows  by  QMULT  (default  =  1).  Remains 

in  effect  until  next  QMULT=  record.  Commonly  used 
to  estimate  ungaged  lateral  inflow  from  a  gaged 
station  by  setting  QMULT  equal  to  the  drainage  area 
ratio, 

QRATIQ  +  Multiply  the  inflow  for  an  entire  simulation  by 

QRATIQ.  This  factor  performs  a  blanket  change 
which  includes  all  the  QMULT  factors. 

ZERQ  +  or  -  Gage  zero  to  be  added  to  the  next  stage  hydrograph 

in  the  input  file  (default  =  0).  Use  additional  ZERQ= 
records  to  add  gage  zero  to  subsequent  hydrographs. 
This  option  is  useful  when  DSS  data  is  stored  as 
stages  rather  than  elevations. 
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Individually  Defined  Parameters  -  Continued. 


Parameter  Value 

WFSTAB  + 

SFSTAB  + 

WFX  + 

-1 

SFX  + 

-1 

DTIC  + 


QTOL  + 

ZTOL  + 

ZSATOL  + 


Description 

The  reach  number  that  corresponds  to  the  river  mile 
entered  on  LATERAL  INFLOW,  UNIFORM  LATERAL 
INFLOW,  CONVEYANCE  CHANGE  and 
DISCHARGE-CONVEYANCE  Records. 

Weir  flow  stability  factor.  Increases  rate  of 
convergence  in  the  numerical  solution  for  submerged 
weirs  (default  =  2.0). 

Spillway  flow  stability  factor.  Increases  rate  of 
convergence  in  the  numerical  solution  for  submerged 
spillways  (default  =  1 .0), 

Weir  flow  submergence  decay  exponent.  Specifies 
the  rate  of  decay  from  free  flow  to  zero  flow  (default  = 
1.0). 

Use  Cunge's  linear  submergence  decay  function. 

Spillway  flow  submergence  decay  exponent. 

Specifies  the  rate  of  decay  free  flow  to  zero  flow 
(default  =  1 .0). 

Use  Cunge's  linear  submergence  decay  function. 

Time  step  during  initialization.  The  time  step  during 
initialization  is  often  less  than  the  base  time  step. 

The  initial  conditions  from  backwater  assumes  a  flow 
distribution  which  is  often  somewhat  different  from  the 
distribution  computed  by  unsteady  flow.  The  smaller 
time  step  helps  the  UNET  program  converge  to  the 
initial  conditions. 

Flow  convergence  error  criterion  in  Newton-Raphson 
solution  (default  =  1 E20  ft®/s). 

Channel  water  surface  elevation  error  criterion  in 
Newton-Raphson  solution  (default  =  0.1  ft). 

Storage  area  water  surface  elevation  error  criterion  in 
Newton-Raphson  solution  (default  =  0.1  ft). 
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Individually  Defined  Parameters  -  Continued. 

_ PsT^Mer  Value  Description 

MAXCRTS  +  Maximum  number  of  interpolated  time  steps 

(default  =  1).  UNET  interpolates  time  steps  on  the 
basis  of  change  in  inflow  and  on  the  basis  of  the 
change  in  computed  stage.  The  stage  criterion  is  set 
byZTOLI  andZSATOLI. 

MXITER  +  Maximum  number  of  iterations  in  Newton-Raphson 

iterative  solution  of  fully  nonlinear  St.  Venant 
equations  (default  =  0).  The  default  value  selects  a 
linearized  solution  to  the  system  of  equations. 

DTMIN  +  Minimum  time  step  (hrs)  for  interpolated  time  steps. 


MAXINSTEPS  +  Maximum  number  of  warm  up  time  steps  (default  = 

20  ).  The  UNET  program  iterates  on  the  first  time 
step  MAXINSTEPS  number  of  times.  The  iteration 
ensures  that  the  simulation  approaches  a  steady 
_ _  state  at  the  start  of  the  dynamic  simulation. 
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Time  Window  (required) 

The  TIME  WINDOW  is  used  to  specify  the  starting  and  ending  times  of  a 
simulation.  It  is  applied  to  all  time  series  data  specified  in  the  UNET  input  file  to  define 
one  or  more  boundary  conditions.  TIME  WINDOW  should  be  placed  immediately  after 
the  JOB  CONTROL  data. 


Command  Line: 

TIME  WINDOW 

Variables: 

SDATE,  STIME,  EDATE,  ETIME 

Variable 

Value 

Description 

SDATE 

Date 

Military  style  starting  date,  for  example  01JAN1984. 

STIME 

Time 

Military  style  starting  time,  for  example  1500  hours. 

EDATE 

Date 

Military  style  ending  date. 

ETIME 

Time 

Military  style  ending  time. 

Example: 

TIME  WINDOW 

24APR1990  0400  24APR1990  0800 


Note: 

When  using  DSS  data,  the  TIME  WINDOW  must  start  and  end  at  DSS  data  points. 
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Appendix  C  -  UNET  Input  Data  Description 


End  of  Job  (required) 

This  data  set  is  required  at  the  end  of  all  UNET  input  files. 


Command  Line:  EJ 


Variables:  None 


Example: 

EJ 
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DSS  Interface  Control 


Open  DSS  File 

This  data  set  specifies  an  existing  DSS  file  to  be  read  for  time  series  data,  the  time 
window  and  TSP.  Once  a  DSS  file  is  open,  other  command  data  sets  may  use  the 
DSS  syntax  to  read  specific  pathnames  from  the  opened  DSS  file  for  input  of  time 
series  data.  An  opened  file  must  be  closed  before  another  DSS  file  can  be  opened. 

Manually  entered  time  series  data  and  the  associated  TIME  WINDOW 
command(s)  must  appear  prior  to  the  OPEN  DSS  FILE  command(s).  The  final 
variable,  TING,  specifies  the  time  increment  of  the  hydrograph  to  be  input  into  UNET. 
Data  in  DSS  files  are  often  stored  at  very  short  time  intervals  i.e.,  1  hour,  2  hours,  etc. 
UNET  has  a  limited  number  of  ordinates  per  hydrograph  (refer  to  the  RDSS  output  file 
under  the  heading  “PROGRAM  DIMENSIONS”).  By  specifying  TING,  values  are  taken 
from  the  DSS  data  base  every  TING  hours. 

Gommand  Line:  OPEN  DSS  FILE 

Variables:  DSSFIL,  SDATE,  STIME,  EDATE,  ETIME,  TING 


Variable 

Value 

Description 

DSSFIL 

Name 

DSS  file  name.  If  not  included,  the  extension  ".DSS" 
will  be  added  automatically.  A  path  of  up  to  40 
characters  including  the  file  name  may  be  specified. 

SDATE 

Date 

Military  style  starting  date,  for  example  01JAN1984. 

STIME 

Time 

Military  style  starting  time,  for  example  1 500  hours. 

EDATE 

Date 

Military  style  ending  date. 

ETIME 

Time 

Military  style  ending  time. 

TING 

+ 

Time  increment  (hrs).  Must  be  an  integer  multiple  of 
the  time  interval  of  the  stored  data. 

Example: 

OPEN  DSS  FILE 


RRH179  01APR1979  1200  30MAY1979  1200  24 

Assume  that  data  is  stored  in  1  hour  increments  in  the  file  RRH179.DSS.  With  TING 
equal  to  24  hours,  every  24th  data  value  would  be  read  from  the  file  beginning  at  noon 
on  April  1 , 1979  and  ending  at  noon  on  May  30, 1979. 

Note:  Indent  DSS  filename  to  avoid  having  the  name  inadvertently  interpreted  as  a 
command. 
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Close  DSS  File 

This  data  set  closes  an  open  DSS  file.  An  opened  DSS  file  must  be  closed  before 
another  is  opened.  Input  of  hydrograph  data  reverts  to  the  standard  syntax. 

Command  Line:  CLOSE  DSS  FILE 

Variables:  None 

Example: 

CLOSE  DSS  FILE 
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Appendix  C  -  UNET  Input  Data  Description 


Initial  Flow  Distribution 

This  data  set  specifies  the  initial  flow  distribution  (initial  conditions)  for  all  reaches. 
If  this  data  set  is  not  specified,  UNET  will  assume  a  starting  flow  distribution.  The 
assumed  distribution  is  usually  adequate  for  dendritic  systems  and  for  simple  networks. 
For  complex  networks  which  typically  have  four  or  more  reaches  intersecting  at  a 
junction,  the  assumed  distribution  may  not  be  reasonable  and  the  program  may  abort 
when  computing  the  initial  water  surface  profiles  or  when  the  unsteady  flow  solution  is 
warming  up. 

The  initial  stages  are  calculated  using  a  backwater  technique.  Because  UNET 
assumes  subcritical  flow  with  downstream  control,  the  reach  numbers  and  discharge 
values  must  be  entered  in  the  backwater  direction,  i.e.,  downstream  to  upstream. 

Command  Line:  INITIAL  FLOW  DISTRIBUTION 

Variables:  (IR,  Q(IR),  IR=I,NRCH) 

IR  +  Reach  number. 

Example: 

INITIAL  FLOW  DISTRIBUTION 
4  2000  3  800  2  1200  1  2000 

or, 

INITIAL  FLOW  DISTRIBUTION 
4  2000 
3  800 
2  1200 
1  2000 

Note: 

Both  input  formats  are  valid  for  all  input  records  requiring  paired  function  data. 
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Initial  Conditions 


Initial  Storage  Area  Elevation 

This  data  set  specifies  the  initial  water  surface  elevation  inside  each  storage  area. 
If  the  INITIAL  STORAGE  AREA  ELEVATION  data  set  is  not  specified  specified,  UNET 
assumes  that  the  initial  storage  area  elevations  are  the  invert  elevations  (ZOSA  on  the 
SA  Record). 

Command  Line:  INITIAL  STORAGE  AREA  ELEVATION 

Variables:  (IR,  ZSA(IR).  IR=I,NSA) 

IR  +  Storage  area  number  (determined  by  the  order  of 

appearance  of  SA  Records  in  the  CSECT  input  file). 

Example: 

INITIAL  STORAGE  AREA  ELEVATION 

1  1000  2  1005  3  995 

or, 

INITIAL  STORAGE  AREA  ELEVATION 
1  1000 

2  1005 

3  995 
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Read  initial  Conditions  File 

Instead  of  specifying  initial  conditions  by  flow  distributions  and  storage  area 
elevations,  initial  conditions  may  be  computed  in  a  prior  execution  of  UNET  and  written 
to  a  binary  fiie  calied  INTL.CON.  This  file  is  created  by  setting  TWIG  in  the  JOB 
CONTROL  data  set  to  the  hour  at  which  the  initial  conditions  are  to  be  written.  The 
UNET  model  is  then  run  with  the  INITIAL  FLOW  DISTRIBUTION  and  INITIAL 
STORAGE  AREA  ELEVATION  data  sets  included.  Two  possible  uses  of  this  feature 
are: 


(1)  Simulations  of  long  duration  may  be  constrained  by  program  parameter  limits 
for  the  number  of  data  points  in  a  hydrograph.  An  initial  conditions  fiie  can  be  used  to 
restart  the  model  to  encompass  the  total  desired  simulation  time. 

(2)  In  multiple  reach  systems,  instabilities  may  be  observed  at  the  initial  time  steps. 
If  these  instabilities  are  significant,  some  final  results  such  as  maximum  water  surface 
profiles  may  be  altered.  An  initial  conditions  file  may  be  written  after  these  instabilities 
have  damped  out.  By  running  the  model  again  with  the  initial  conditions  file,  the  impact 
of  the  instabilities  is  removed  from  the  computations. 

Command  Line:  BEAD  INITIAL  CONDITIONS 

Variables:  FILNM 

Variable  Value  Description 

FILNM  Alpha  INTL.CON  (This  default  can  be  changed  with  DOS 

Example: 

READ  INITIAL  CONDITIONS 
INTL.CON 
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Upstream  Flow  or  Stage  Hydroqraph 

This  data  set  specifies  a  flow  (or  stage)  hydrograph  to  be  used  as  an  upstream 
boundary  condition  for  reach  IRCH.  If  a  DSS  file  is  open,  the  DSS  syntax  should  be 
used  to  define  the  DSS  pathname,  otherwise  use  one  of  the  standard  syntaxes  to 
describe  the  hydrograph. 

Command  Line:  UESTREAM  FLOW  HYDROGRAPH  (or  LESTREAM  STAGE 
HYDROGRAPH) 

Variables:  Standard  syntax 

IRCH,  NU,  (UT(J),  UQ(J),  J=1,NU)  (without  TINC) 

IRCH,  NU,  (UQ(J),  J=1,NU)  (with  TINC) 


IlSS.?ynta?( 
IRCH  (1st  line) 
PN  (2nd  line) 


Variable 

Value 

Description 

IRCH 

+ 

Reach  number. 

NU 

+ 

Number  of  hydrograph  ordinates. 

UT(J) 

+ 

Time  values  (hrs).  Omitted  if  TINC  is  specified  via  the  TIME 
INCREMENT  command. 

UQ(J) 

+ 

Flow  values  (E/s)  (or  elevations  in  ft.). 

PN 

A80 

DSS  pathname  (left  justified,  must  include  parts  A-F). 

Examples  f Standard  syntaxi: 

UPSTREAM  FLOW  HYDROGRAPH 
1  4  0  2000  1  4000  2  3000  3  2000  (without  TINC) 

1  4  2000  4000  3000  2000  (with  TINC) 

or  an  alternate  method,  helpful  for  hydrographs  with  many  data  pairs. 


UPSTREAM  FLOW  HYDROGRAPH 
1  4 

0  2000 

1  4000 

2  3000 

3  2000 


UPSTREAM  FLOW  HYDROGRAPH 
1  4 
2000 
4000 
3000 
2000 
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Upstream  Flow  or  Stage  Hydrograph  -  Continued. 

Example  (DSS  syntax^: 

UPSTREAM  FLOW  HYDROGRAPH 
1 

/RED  RIVER/63000/FLOW/01JAN 1979/1  DAY/COMPUTED/ 
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Upstream  Boundary  Conditions 


The  upstream  stage  and  flow  hydrograph  is  a  mixed  boundary  condition  where  a 
stage  hydrograph  is  inserted  as  the  upstream  boundary  until  the  stage  hydrograph  runs 
out  of  data;  afterward  a  flow  hydrograph  is  used.  The  end  of  data  is  identified  by  the 
HEC-DSS  missing  data  code  -901 .0.  The  stage  and  flow  hydrographs  can  be  entered 
either  in  a  table  or  from  DSS.  The  mixed  boundary  condition  is  primarily  used  for 
forecast  models  where  the  end  of  stage  data  is  the  forecast  time  and  the  flow 
hydrograph  is  the  flow  forecast. 


Command  Line: 


UPSTREAM  STAGE  AND  FLOW  HYDROGRAPH 


Variables: 


IRCH,  NU,  (UT(J),  UZ(J),UQ(J).  J=1,NU) 


IRCH  (1st  line) 

PN  (2nd  line)  stage 
PN  (3rd  line)  flow 


Variable  Value  Description 


IRCH 


Reach  number. 


UT(J) 

UZ(J) 

UQ(J) 


Number  of  hydrograph  ordinates. 
Time  values  (hrs). 

Stage  value  (ft). 

Flow  values  (ft®/s). 


DSS  pathname  (left  justified,  must  include  parts  A-F). 


mmmmmmsm 


UPSTREAM  STAGE  AND  FLOW  HYDROGRAPH 
1  4 

0  451  -901. 

24  451  2000 

48  -901  2000  <==  Start  using  flow  hydrograph 

72  -901  2000 


UPSTREAM  FLOW  HYDROGRAPH 
1 

/RED  RIVER/JONESBURO/STAGE/01JAN1 979/1  DAY/COMPUTED/ 
/RED  RIVER/JONESBURO/FLOW/01JAN 1979/1  DAY/COMPUTED/ 
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Critical  Upstream  Boundary 

UNET  has  the  capacity  to  dynamically  select  the  computational  time  step  (DT  in 
the  JOB  CONTROL  data  set).  Smaller  time  steps  may  be  required  when  inflow  rates 
are  changing  rapidly.  By  specifying  the  previous  upstream  flow  hydrograph  as  a 
"critical"  upstream  boundary  condition,  UNET  will  monitor  the  rate  of  change  of  the 
specified  inflow.  If  the  rate  of  change  in  inflow  exceeds  DCRUP  between  any  two 
consecutive  flow  values,  DT  will  be  adjusted  according  to  the  following  equation: 


NEW  DT  - 


_ BASE  DT _ 

AMAX1{NINT{DQ{J)  -r  DCRUP{J)),1) 


where;  NEW  DT 
BASE  DT 
DQ(J) 
DCRUP(J) 


the  adjusted  computational  time  step, 

the  initial  user  specified  computational  time  step, 

change  in  upstream  inflow  between  previous  and  current  times, 

maximum  change  in  upstream  inflow  between  computation 

times,  and  where  the  denominator  is  computed  as  an  integer 

result. 


This  command  is  placed  immediately  after  the  upstream  boundary  condition  for 
which  it  applies. 


Command  Line:  CRITICAL  UPSTREAM  BOUNDARY 


Variables:  DCRUP 


^riabte^^>/al^ 

DCRUpi™' . + . 


Example: 


^Desci^ 


ion 


The  maximum  change  in  inflow  allowed  without 
adjusting  the  computational  time  step,  DT. 


CRITICAL  UPSTREAM  BOUNDARY 
500 
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Downstream  Boundary  Conditions 


Downstream  Flow  Hydrograph 

This  data  set  specifies  a  flow  hydrograph  to  be  used  as  a  downstream  boundary 
condition  for  reach  IRCH.  If  a  DSS  file  is  open,  the  DSS  syntax  should  be  used  to 
define  the  DSS  pathname,  otherwise  use  one  of  the  standard  syntaxes  to  describe  the 
hydrograph.  The  initial  water  surface  elevation  is  given  by  ZDB. 

Command  Line:  DQWNSTREAM  FLOW  HYDROGRAPH 

Variables:  Standard  syntax 

IRCH,  ZDB,  NDB,  (DBT(J),  DBQ(J),  J=I,NDB)  (without  TINC) 
IRCH,  ZDB,  NDB,  (DBQ(J),  J=1,NDB)  (with  TINC) 

DSS  syntax 
IRCH  (1st  line) 

ZDB  (2nd  line) 

PN  (3rd  line) 


Variable 

Value 

Description 

IRCH 

+ 

Reach  number. 

ZDB 

.  + 

Initial  water  surface  elevation  (ft). 

NDB 

+ 

Number  of  hydrograph  ordinates. 

DBT(J) 

+ 

Time  values  (hrs).  Omitted  if  TINC  is  specified  via  the 
TIME  INCREMENT  command. 

DBQ(J) 

+ 

Flowrates  (ft%). 

A80 

DSS  pathname  (left  justified,  must  include  parts  A-F). 

Examples  (Standard  syntaxi: 

DOWNSTREAM  FLOW  HYDROGRAPH 
1  694.5  4  0  2000  1  4000  2  3000  3  2000  (without  TINC) 

1  694.5  4  2000  4000  3000  2000  (with  TINC) 

For  an  alternate  method,  helpful  for  hydrographs  with  many  data  pairs,  see  the  input 
description  for  Upstream  Flow  Hydrographs. 

Example  fPSS  syntaxi: 

DOWNSTREAM  FLOW  HYDROGRAPH 
1 

1000 

/RED  RIVER/65000/FLOW/01JAN 1979/1  DAY/COMPUTED/ 
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Downstream  Stage  Hydrograph 

This  data  set  specifies  a  stage  hydrograph  to  be  used  as  a  downstream  boundary 
condition  for  reach  IRCH.  If  a  DSS  file  is  open,  the  DSS  syntax  should  be  used  to 
define  the  DSS  pathname,  otherwise  use  one  of  the  standard  syntaxes  to  describe  the 
hydrograph. 

Command  Line:  DOWNSTREAM  STAGE  HYDROGRAPH 

Variables:  Standard  Syntax 

IRCH,  NDB,  (DBT(J),  DBZ(J),  J=1,NDB)  (without  TINC) 

IRCH,  NDB,  (DBZ(J),  J=1,NDB)  (with  TINC) 

DSS  Syntax 
IRCH  (1st  line) 

PN  (2nd  line) 


Variable  Value  Description 


IRCH 

+ 

Reach  number. 

NDB 

+ 

Number  of  hydrograph  ordinates. 

DBT(J) 

+ 

Time  values  (hrs).  Omitted  if  TINC  is  specified  via  the 
TIME  INCREMENT  command. 

DBZ(J) 

+ 

Water  surface  elevations  (ft). 

PN 

A80 

DSS  pathname  (left  justified,  must  include  parts  A-F). 

Examples  (Standard  syntaxi: 
DOWNSTREAM  STAGE  HYDROGRAPH 
1  4  0  1000  1  1010  2  1005  3  1000 


For  an  alternate  method,  helpful  for  hydrographs  with  many  data  pairs,  see  the  input 
description  for  Upstream  Flow  Hydrographs. 

Example  (DSS  syntaxi: 

DOWNSTREAM  STAGE  HYDROGRAPH 
1 

/RED  RIVER/OSLO/STAGE/01 JAN1 979/1  DAY/COMPUTED/ 
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Downstream  Boundary  Conditions 


Downstream  Stage  and  Flow  Hydrograph 

The  downstream  stage  and  flow  hydrograph  is  a  mixed  boundary  condition  where 
a  stage  hydrograph  is  inserted  as  the  downstream  boundary  until  the  stage  hydrograph 
runs  out  of  data;  afterward  a  flow  hydrograph  is  used  .  The  end  of  data  is  identified  by 
the  HEC-DSS  missing  data  code  of  -901 .0.  The  stage  and  flow  hydrographs  can  either 
be  entered  in  a  table  or  can  be  entered  from  DSS.  The  mixed  boundary  condition  is 
primarily  used  for  forecast  models  where  the  end  of  stage  data  is  the  forecast  time  and 
the  flow  hydrograph  is  the  flow  forecast. 

Command  Line:  DQWNSTREAM  STAGE  AND  FLOW  HYDROGRAPH 

Variables:  Standard  syntax 

IRCH,  ND,  (DBT(J),DBZ(J),DBQ(J),  J=1,ND) 

DSS  syntax 
IRCH  (1st  line) 

PN  (2nd  line)  stage 
PN  (3rd  line)  flow 


Variable 

Value 

Description 

IRCH 

+ 

Reach  number. 

ND 

+ 

Number  of  hydrograph  ordinates. 

UT(J) 

+ 

Time  values  (hrs). 

DBZ(J) 

+ 

Stage  value  (ft). 

DBQ(J) 

+ 

Flow  values  (ft®/s). 

PN 

A80 

DSS  pathname  (left  justified,  must  include 
parts  A-F). 

Examples  (Standard  syntax): 

DOWNSTREAM  STAGE  AND  FLOW  HYDROGRAPH 
1  4 

0  451  -901. 

24  451  2000 

48  -901  2000  <==  Start  using  flow  hydrograph 
72  -901  2000 

Example  (DSS  syntax): 

DOWNSTREAM  FLOW  HYDROGRAPH 
1 

/RED  RIVER/JONESBURO/STAGE/01JAN1 979/1  DAY/COMPUTED/ 
/RED  RIVER/JONESBURO/FLOW/01 JAN1979/1  DAY/COMPUTED/ 
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Appendix  C  -  UNET  Input  Data  Description 


Downstream  Rating  Curve 

This  data  set  specifies  a  single  valued  (non-looped)  rating  curve  to  be  used  as  a 
downstream  boundary  condition  for  reach  IRCH.  The  downstream  rating  curve  option 
can  only  be  used  once.  This  boundary  condition  should  be  used  with  caution. 
Differences  between  this  rating  curve  and  the  real  looped  curve  may  cause  errors  in  the 
solution  far  upstream  of  the  downstream  boundary.  This  becomes  a  problem  for 
streams  with  mild  gradients  where  the  slope  of  the  water  surface  does  not  sufficiently 
dampen  out  the  errors.  This  rating  curve  should  be  inserted  a  sufficient  distance 
downstream  of  the  study  area  so  that  errors  are  not  propagated  upstream  into  the  study 
area.  Similar  considerations  apply  to  HEC-2  applications. 

Command  Line:  DOWNSTREAM  RATING  CURVE 

Variables:  IRCH,  NDB,  (DBZ{J),  DBQ(J),  J=1  ,NDB) 


Variable 

Value 

Description 

IRCH 

+ 

Reach  number. 

NDB 

+ 

Number  of  rating  curve  ordinates  (limited  to  20 
points). 

DBZ(J) 

+ 

Water  surface  elevations  (ft). 

DBQ(J) 

+ 

Flow  rates  (ft®/s). 

Example: 

DOWNSTREAM  RATING  CURVE 

1  5  100  2000  105  2400  110  3000  115  4000  120  6000 

or, 

1  5 

100  2000 
105  2400 
110  3000 
115  4000 
120  6000 
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Downstream  Boundary  Conditions 


This  data  set  specifies  that  an  approximate  looped  rating  curve  will  be  calculated 
dynamically  by  UNET  for  use  as  the  downstream  boundary  condition  for  reach  IRCH. 
Manning's  equation  is  used  to  compute  an  estimate  of  the  friction  slope  at  each  time 
step  between  the  two  most  downstream  cross  sections.  Because  the  method  neglects 
the  nonuniform  and  unsteady  terms  of  the  momentum  equation,  and  only  considers  the 
final  two  cross  sections,  the  approximation  is  quite  crude.  As  recommended  in  the 
description  of  the  single-valued  rating  curve,  this  boundary  condition  should  also  be 
inserted  downstream  from  the  area  of  interest  being  studied. 


Command  Line:  DOWNSTREAM  MANNING’S  EQUATION 


Variables:  IRCH,  DSF 


IRCH  +  Reach  number. 


DSF  +  Estimate  of  initial  friction  slope,  S,.  Water  surface 


slooe  is  a  aood  estimate. 


DOWNSTREAM  MANNING'S  EQUATION 
1  0.00478 
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Pump  Station  as  a  Downstream  Boundary  Condition 

This  data  set  inserts  a  pumping  station  as  a  downstream  boundary  for  a  reach. 

The  pumping  station  capacity  is  defined  as  stair-stepped  rating  where  the  pumps  are 
started  at  a  set  elevation  and  stopped  at  a  lower  elevation.  The  capacity  remains 
constant  until  the  next  elevation  when  the  next  group  of  pumps  are  started.  Neither  the 
submergence  of  the  pumps  nor  the  pump  characteristics  are  considered  in  the 
calculations. 

Command  Line:  DOWNSTREAM  PUMPING  STATION 


Variables:  IRCH,  NPDS,  (ZPUMPSTART(I),  ZPUMPSTOP(I). 

QDSPUMP(I),  1=1, NPDS) 


Variable 

Value 

Description 

IRCH 

+ 

Reach  number. 

NPDS 

+ 

Number  of  pumping  levels  (or  steps) 

ZPUMPSTART(I) 

+ 

Elevation  when  pumping  level  1  is  started  on  the 
rising  limb  of  the  stage  hydrograph. 

ZPUMPSTOP(I) 

+ 

Elevation  when  pumping  level  1  is  stopped  on  the 
falling  limb  of  the  stage  hydrograph. 

QDSPUMP(I) 

+ 

Pumping  capacity  at  level  1. 

Example: 

DOWNSTREAM  PUMPING  STATION  -  PARISH  LINE  PUMPING  STATION 

47 

4 

000 

14  13  1000 
16  15  2000 
18  17  4000 

For  the  above  example,  the  pumps  are  completely  shut  down  below  elevation  13. 

When  the  stage  exceeds  elevation  14  the  pumps  are  started  with  a  capacity  of  1000. 
When  the  stage  exceeds  1 6,  the  next  set  of  pumps  are  started  with  a  total  capacity  of 
2000.  On  the  falling  limb,  when  the  stage  drops  below  1 5,  the  second  set  of  pumps  are 
stopped  and  the  pumping  continues  at  a  rate  of  1000. 


C-31 


Appendix  C  -  UNET  Input  Data  Description 


Internal  Boundary  Conditions 


Lateral  Inflow  Hydrograph 

This  data  set  specifies  a  lateral  inflow  hydrograph  which  enters  the  model  at  a 
point  along  the  stream.  Effects  of  this  inflow  on  flow  and  stage  in  the  receiving  reach 
will  be  seen  at  the  next  downstream  cross  section.  Lateral  inflows  may  also  enter  a 
storage  area  by  adding  the  string  STORAGE  AREA  to  the  command  line.  Lateral 
inflows  defined  using  standard  syntax  must  appear  after  a  TIME  WINDOW  command 
and  prior  to  any  OPEN  DSS  FILE  commands.  The  Lateral  Inflow  Hydrograph 
command  must  be  preceded  by  a  “REACH=”  command,  in  order  to  find  a  match 
between  reach  and  river  mile. 

Command  Line:  LATERAL  INFLOW  HYDROGRAPH,  or 

LATERAL  INFLOW  HYDROGRAPH  INTO  A  STORAGE  AREA 

Variables:  Standard  syntax 

RMILE,  NPQL,  (TQL(J),  QL(J),  J=I,NPQL)  (without  TING) 
RMILE,  NPQL,  (QL(J),  J=1,NPQL)  (with  TING) 


DSS  syntax 
RMILE  (1st  line) 
PN  (2nd  line) 


Variable 

Value 

Description 

RMILE 

+ 

River  mile  where  lateral  inflow  enters  the  stream 
(SECNAM  on  CSECT  XI  Records). 

- 

User  defined  storage  area  number  if  STORAGE 

AREA  string  is  specified  in  command  line. 

NPQL 

+ 

Number  of  hydrograph  ordinates. 

TQL(J) 

+ 

Time  values  (hrs).  Omitted  if  TING  is  specified  via  the 
TIME  INCREMENT  command. 

QL(J) 

+ 

Flow  rates  (ft®/s). 

PN 

A80 

DSS  pathname  (left  justified,  must  include  parts  A-F). 

Examples  (Standard  syntaxV 

REACH=4 

LATERAL  INFLOW  HYDROGRAPH 
2.0 
5 

0  500 

1  500 

2  750 
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Lateral  Inflow  Hydrograph  -  Continued. 

3  500 

4  500 


REACH=4 

LATERAL  INFLOW  HYDROGRAPH  INTO  A  STORAGE  AREA 
2.0 
5 

0  500 

1  500 

2  750 

3  500 

4  500 


Example  (DSS  syntax): 

REACH=4 

LATERAL  INFLOW  HYDROGRAPH 

2.0 

/RED  RIVER/TURTLE/FLOW/01JAN 1 979/1  DAY/COMPUTED/ 
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Internal  Boundary  Conditions 


Uniform  Lateral  Inflow  Hydrograph 

This  data  set  specifies  a  lateral  inflow  hydrograph  to  be  applied  uniformly  along  a 
reach  between  two  specified  cross  sections,  and  represents  the  total  flow  entering  the 
reach.  Uniform  lateral  inflows  entered  using  standard  syntax  must  appear  after  a  TIME 
WINDOW  command  and  prior  to  any  OPEN  DSS  FILE  commands.  The  record  must 
be  preceded  by  a  REACH=  command,  in  order  to  match  the  river  mile  to  a  specific  river 
reach. 


Command  Line:  UNIFORM  LATERAL  INFLOW  HYDROGRAPH 


Variables: 

Standard  syntax: 

RMILEU,RMILED,NPUQL,  (UTQL(J),  UQL(J),  J=1, NPUQL) 
(without  TING) 

RMILEU,  RMILED,  NPUQL,  (UQL(J),  J=1, NPUQL)  (with  TING) 

DSS  syntax: 

RMILEU,  RMILED  (1st  line) 

PN  (2nd  line) 

Variable 

Value 

Description 

RMILEU 

+ 

Upstream  river  mile. 

RMILED 

+ 

Downstream  river  mile. 

NPUQL 

+ 

Number  of  hydrograph  ordinates. 

UTQL(J,NPUQL) 

+ 

Time  values  (hrs).  Omitted  if  TING  is  specified  via  the 
TIME  INCREMENT  command. 

UQL{J,NPUQL) 

+ 

Flow  rates  (ft%). 

A80 

DSS  pathname  (left  justified,  must  include  parts  A-F). 

Example  (Standard  syntax^ 

REACH=4 

UNIFORM  LATERAL  INFLOW  HYDROGRAPH 


5.0  4.0 
5 

0  500 

1  500 

2  750 

3  500 

4  500 

Example  fPSS  syntax^: 
REACH=4 


C-34 


Internal  Boundary  Conditions 


Appendix  C  -  UNET  Input  Data  Description 


Uniform  Lateral  Inflow  Hydrograph  -  Continued. 

UNIFORM  LATERAL  INFLOW  HYDROGRAPH 
5.0  4.0 

/RED  RIVER/RETURN/FLOW/01JAN1 979/1  DAY/COMPUTED/ 
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Internal  Boundary  Conditions 


Critical  Lateral  Inflow 


UNET  has  the  capability  to  dynamically  select  the  computational  time  step  (DT  in 
the  JOB  CONTROL  data  set).  Smaller  time  steps  may  be  required  when  inflow  rates 
are  changing  rapidly.  By  specifying  the  previous  lateral  inflow  as  a  "critical"  lateral 
inflow,  UNET  will  monitor  the  rate  of  change  of  the  specified  inflow.  If  the  rate  of 
change  in  inflow  exceeds  DCRLQ  between  any  two  consecutive  flow  values,  DT  will  be 
adjusted  according  to  the  following  equation: 


NEW  DT  = 


_ BASE  DT _ 

AMAX1{NINT{DLQ{J)  -r  DCRLQ{J)),1) 


where:  NEWDT 
BASE  DT 
DLQ(J) 
DCRLQ(J) 


the  adjusted  computational  time  step, 

the  initial  user  specified  computational  time  step, 

change  in  lateral  inflow  between  previous  and  current  times, 

maximum  change  in  lateral  inflow  between  computation  times. 


Command  Line:  CRITICAL  LATERAL  I N FLOW 

Variables:  ICRLQ,  DCRLQ 


Variable 

Value 

Description 

ICRLQ 

+ 

Upstream  node  number  corresponding  to  the  lateral 
or  uniform  lateral  inflow  to  be  designated  as  "critical". 
The  node  number  can  be  obtained  from  the  CSECT 
output  file. 

DCRLQ 

+ 

The  maximum  change  in  lateral  inflow  allowed  without 
adjusting  the  computational  time  step,  DT. 

Example: 

CRITICAL  LATERAL  INFLOW 
10 
500 
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Interflow  between  a  Groundwater  Reservoir  and  a  River 

This  data  set  identifies  a  reach  of  river  which  exchanges  water  with  a  goundwater 
reservoir.  The  stage  in  the  groundwater  reservoir  is  assumed  independent  of  the 
interflow  and  entered  either  manually  or  from  DSS.  The  interflow  functions  similar  to  a 
uniform  lateral  inflow  where  the  flow  is  proportional  to  the  head  between  the  river  and 
the  groundwater  reservoir. 

Command  Line;  GROUNDWATER  INTERFLOW  BETWEEN  CANAL  AND  AREA  1 

Variables:  Standard  syntax: 

RMILEU.RMILED.DARCYK.DX.NPZGW, 

(TIME(J),  ZGW{J),  J=1,NPZGW) 

DSS  syntax: 

RMILEU.RMILED.DARCYK.DX 

PN  (2nd  line) 


Variable 

Value 

Description 

RMILEU 

+ 

Upstream  river  mile. 

RMILED 

+ 

Downstream  river  mile. 

DARCYK 

+ 

Darcy’s  groundwater  loss  coefficient. 

DX 

Distance  over  which  the  head  acts. 

NPZGW 

+ 

Number  of  groundwater  stages. 

TIME(J) 

+ 

Time  J. 

ZGW(J) 

+ 

Groundwater  stage  at  time  J. 

PN 

A80 

DSS  pathname  (left  justified,  must  include  parts  A-F). 

Example  (Standard  syntax): 

REACH=4 

GROUNDWATER  INTERFLOW  BETWEEN  CANAL  7  AND  WESTERN  AQUIFER 
10.0  6.0  .4  2000 
3 

0.0  -6.3 
24.0  -6.0 
48.0  -6.3 
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Internal  Boundary  Conditions 


Time  Series  of  Gate  Openings 

This  data  set  specifies  a  time  series  of  gate  openings  for  radial  (fainter)  gates  on 
cross-channel  and  lateral  spillways.  Gate  openings  are  interpolated  between  entered 
values. 


Command  Line: 

GATE  OPENING 

Variables: 

Standard  syntax: 

IBC  (1st  line) 

NGO  (TGO(l),GO(l),l=1,NGO)  (2nd  line) 

DSS  syntax: 

IBC  (1st  line) 

PN  (2nd  line) 

Variable 

Value 

Description 

IBC 

+ 

Internal  boundary  condition  number.  This  number  is 
obtained  from  the  CSECT  output  file  in  the  listing  of 
“Navigation  Dams  and  Spillways".  It  Is  a  counter 
based  on  the  order  that  various  internal  boundary 
conditions  are  entered  in  the  CSECT  input  file. 

Alpha 

CSECT  CSPNAME  from  LA,  LS,  SP  Records. 

NGO 

+ 

Number  of  points  in  the  time  series. 

TGO 

+ 

Time  values  (hrs). 

GO 

+ 

Gate  opening  (ft)  at  each  TGO  time  value  (ft). 

PN 

A80 

DSS  pathname  (left  justified,  must  include  parts  A-F). 

Example  (Standard  syntax^: 

GATE  OPENING 
1 
5 

0  0.0  0.25  2.0  0.5  4.0  0.75  6.0  1  8.0 

For  an  alternate  method,  helpful  for  time  series  with  many  data  pairs,  see  the  input 
description  for  Upstream  Flow  Hydrographs. 

Example  fPSS  syntax^: 

GATE  OPENING 
1 

/OHIO/DAM25/GATOP/01 JAN1 979/1 5MIN/COMPUTED/ 
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Elevation  Controlled  Gate 

The  elevation  controlled  gate  opens  when  the  stage  in  the  river  exceeds 
elevation,  ZECOPEN.  The  gate  opens  at  a  rate  of  ECOPRATE  until  it  reaches  a 
maximum  opening  of  ECMXOPENING.  When  the  river  stage  falls  below  ZECCLOSE 
the  gate  begins  to  close  at  a  rate  of  ECCLRATE. 

Command  Line:  ELEVATION  CONTROLLED  GATE 


Variables:  IBC  (1st  line) 

ZECOPEN,  ZECCLOSE,  ECOPRATE,  ECCLRATE, 
ECMXOPENING,  ECMINOPENING  (2nd  line) 


Variable 

Value 

Description 

IBC 

+ 

Internal  boundary  condition  number.  This  number 
is  obtained  from  the  CSECT  output  file  in  the 
listing  of  "Spillways".  It  is  a  counter  based  on  the 
order  that  various  internal  boundary  conditions  are 
entered  in  the  CSECT  input  file. 

Alpha 

CSECT  CSPNAME  from  LA,  LS,  SP  Records. 

ZECOPEN 

+ 

Elevation  (ft)  at  which  the  gate  begins  to  open. 

ZECCLOSE 

+ 

Elevation  (ft)  at  which  the  gate  begins  to  close. 

ECOPRATE 

+ 

Opening  rate  in  ft/min. 

ECCLRATE 

+ 

Closing  rate  in  ft/min. 

ECMXOPENING 

+ 

Maximum  gate  opening  in  feet. 

ECMINOPENING 

+ 

Minimum  gate  opening  in  feet. 

Example: 

ELEVATION  CONTROLLED  GATE  AT  LEVEE  SWAIL 
1 

200  196  .5  .6  50.1 
or 

ELEVATION  CONTROLLED  GATE 
ABC 

200  196  .5  .6  50.1 
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Internal  Boundary  Conditions 


This  data  set  specifies  an  observed  time  series  of  navigation  pool  water  surface 
elevations  upstream  of  unregulated  navigation  dams.  The  stage  hydrograph  can  be 
entered  using  either  the  standard  or  DSS  syntaxes.  In  a  forecasting  model,  the 
observed  pool  elevations  are  used  as  an  internal  boundary  condition  up  to  the  time  of 
forecast.  At  this  point,  the  ND  and  CP  Records  in  the  CSECT  input  file  provide  the 
model  with  the  information  neccessary  to  control  the  hinge  point  operation  of  the 
navigation  dam. 


Command  Line:  OBSERVED  STAGE 


BOUNDARY 


Variables: 


IBC,  NIBCI,  (TIBCI(I),  ZIBCI(I),  l=1,NIBCI) 


IBC  (1st  line) 
PN  (2nd  line) 


Variable 


IBC 


NIBCI 


TIBCI 


Value  Description 


+  Internal  boundary  condition  number.  This  number  is 

obtained  from  the  CSECT  output  file  in  the  listing  of 
"Navigation  Dams  and  Spillways".  It  is  a  counter 
based  on  the  order  that  various  internal  boundary 
conditions  are  entered  in  the  CSECT  input  file. 

+  Number  of  points  in  the  hydrograph. 

+  Time  values  (hrs). 


ZIBCI 


Navigation  pool  elevation  values  (ft). 


DSS  pathname  (left  justified,  must  include  parts  A-F) 


Internal  Boundary  Conditions 
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Stage  and  Flow  Internal  Boundary  Condition 

The  observed  stage  and  flow  internal  boundary  condition  is  a  mixed  boundary 
condition  where  a  stage  hydrograph  is  inserted  as  the  observed  boundary  until  the 
stage  hydrograph  runs  out  of  data;  afterward  a  flow  hydrograph  is  used.  The  end  of 
data  is  identified  by  the  HEC-DSS  missing  data  code,  -901 .0.  The  stage  and  flow 
hydrographs  can  either  be  entered  in  a  table  or  can  be  entered  from  DSS.  The  mixed 
boundary  condition  is  primarily  used  for  forecast  models  where  the  end  of  stage  data  is 
the  forecast  time  and  the  flow  hydrograph  is  the  flow  forecast. 

Command  Line:  OBSERVED  STAGE  AND  FLOW  INTERNAL  BOUNDARY 

CONDITION 

Variables:  Standard  syntax 

IBC,  NIBCI,  (T(J),  ZIBCI(J),QIBCI(J),  J=1,NU) 

DSS  syntax 
IBC  (1st  line) 

PN  (2nd  line)  stage 
PN  (3rd  line)  flow 


Variable 

Value 

Description 

IBC 

+ 

Internal  boundary  condition  number  from  CSECT  file. 

NIBCI 

+ 

Number  of  hydrograph  ordinates 

T(J) 

+ 

Time  values  (hrs). 

ZIBCI(J) 

+ 

Stage  value  (ft). 

QIBCI(J) 

+ 

Flow  values  (ft®/s). 

PN 

A80 

DSS  pathname  (left  justified,  must  include  parts  A-F). 

Examples  (Standard  syntaxV 

OBSERVED  STAGE  AND  FLOW  INTERNAL  BOUNDARY  CONDITION 

1  4 

0  451  -901. 

24  451  2000 

48  -901  2000  <==  Start  using  flow  hydrograph 

72  -901  2000 
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Internal  Boundary  Conditions 


Observed  Stage  and  Flow  Internal  Boundary  Condition  -  Continued. 

Example  (DSS  syntax^ 

OBSERVED  STAGE  AND  FLOW  INTERNAL  BOUNDARY  CONDITION 
1 

/RED  RIVER/JONESBURO/STAGE/01JAN1 979/1  DAY/COMPUTED/ 
/RED  RIVER/JONESBURO/FLOW/01 JAN1979/1  DAY/COMPUTED/ 
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Conveyance  Change  Factors 

This  data  set  can  be  used  to  adjust  conveyance  and  storage  between  cross 
sections  defined  on  X1  Records  in  the  CSECT  input  file.  This  option  is  primarily  a 
calibration  tool  which  allows  the  user  to  vary  conveyance  and  storage  without  having  to 
re-run  CSECT. 

Command  Line:  CONVEYANCE  CHANGE 


Variables:  RMILEU,  RMILED,  IEL1 ,  IEL2,  FV,  FCS,  FVS,  ELADD,  AN 


Variable 

Value 

Description 

RMILEU 

+ 

Upstream  river  mile  (SECNAM  on  XI  Record  in 
CSECT  input  file). 

RMILED 

+ 

Downstream  river  mile  (SECNAM  on  XI  Record  in 
CSECT  input  file). 

IEL1 

+ 

Minimum  table  entry  (CSECT  tables)  for  adjustments 
(ex.  1-21). 

IEL2 

+ 

Maximum  table  entry  (CSECT  tables)  for  adjustments 
(ex.  1-21). 

FC 

+ 

Conveyance  change  factor  for  channel. 

FV 

+ 

Conveyance  change  factor  for  overbanks. 

FCS 

+ 

Storage  factor  to  multiply  by  channel  area.  Resulting 
area  will  be  added  to  current  storage  area  for  this 
cross  section. 

FVS 

+ 

Storage  factor  to  multiply  by  overbank  area. 

Resulting  area  will  be  added  to  current  storage  area 
for  this  cross  section. 

ELADD 

+ 

Elevation  increment  to  be  added  to  cross  sections  (ft). 

AN 

+ 

Coefficient  for  the  added  force  term  in  the  momentum 
equation. 

Example: 

REACH=4 

CONVEYANCE  CHANGE  FACTORS 

10.0  4.0  10  21  .95  1.1  0.0  .15  0.1  1.2 

C-43 


Appendix  C  -  UNET  Input  Data  Description 


Calibration  Options 


Discharge  -  Conveyance  Relation 

This  data  set  is  used  to  redefine  a  discharge  versus  conveyance  rating  curve 
between  cross  sections  defined  by  X1  Records  in  the  CSECT  input  file.  A  maximum  of 
fifty  curves,  each  containing  up  to  twenty  values  of  discharge  and  conveyance  can  be 
computed. 

Command  Line:  DISCHARGE  CONVEYANCE  RELATION 


Variables: 

RMILEU,  RMILED,  QCSTRT,  QCINC,  NQCPT, 

(0(1),  FCONV(I),  1=1, NQCPT) 

Variable 

Value 

Description 

RMILEU 

+ 

Upstream  river  mile  (SECNAM  on  XI  Record 
from  CSECT  input  file). 

RMILED 

+ 

Downstream  river  mile  (SECNAM  on  XI 

Record  from  CSECT  input  file). 

QCSTRT 

+ 

Starting  (lowest)  discharge  on  curve  (ft®/s). 

QCINC 

+ 

Increment  between  discharges  on  the  curve 
(ft®/s). 

NQCPT 

+ 

Number  of  discharge  increments  on  the  curve. 

Q 

+ 

Discharge  Identifier.  For  the  convenience  of 
the  user  to  identify  flows  associated  with 
conveyance  factors  (not  used  by  the  program). 

FCONV(l,  NQCPT) 

+ 

Conveyance  change  factors  corresponding  to 
the  series  of  discharges.  These  factors  adjust 
the  conveyances  computed  by  CSECT  and 
provide  a  calibration  tool  whereby  conveyance 
in  a  given  reach  may  be  adjusted  without 
editing  the  CSECT  input  file. 

Example: 

REACH=4 

DISCHARGE  CONVEYANCE  RELATION 

10.0  4.0  500  1000  20 

500  0.9 

1000  0.95 
. . .  Q,  FCONV(20) 
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Figure  D-1  presents  a  simple  full  network  problem.  Flow  from  reach  1  splits  into 
reaches  2  and  3  around  the  island,  then  recombines  downstream  into  reach  4. 
Additionally,  flow  from  reach  2  is  diverted  into  a  storage  area.  System  bed  slope  is  0.5 
ft/mile  (0.000095  ft/ft).  Channel  and  overbank  Manning’s  n  values  are  0.03  and  0.08 
respectively. 


1 

Reach 

1 

Island 

Reach  3 

SA  #1 

Reach  2 

Reach 

4 

Figure  D-1  Example  problem  with  4  reaches  and  a  storage  area. 


Figures  D-2  through  D-4  show  the  cross  sections  used  in  the  problem.  Reaches  1  and 
4  consist  of  a  250  foot  wide  cross  section  with  a  channel  top  width  of  45  feet.  Reaches 
2  and  3  have  1 30  foot  wide  cross  sections.  Reach  2  has  a  channel  top  width  of  40  feet 
while  reach  3  has  a  channel  top  width  of  20  feet. 

D.1  CSECT  Input  File 

Table  D-1  is  the  CSECT  input  file  for  this  problem.  Appendix  B  contains  detailed 
descriptions  of  each  input  record.  The  four  reaches  are  arranged  in  order  from 
upstream  to  downstream.  Each  reach  begins  with  a  set  of  title  records  (T1 ,  T2,  T3). 
Cross  sections  may  be  plotted  using  the  program  PLOT2  (HEC,  1990c)  or  HEC-RAS. 
To  use  PLOT2,  a  blank  J1  record  should  be  inserted  after  the  first  set  of  title  records 
and  each  XI  record  must  have  a  unique  cross  section  number  (SECNAM)  in  field  1 . 

The  XK  record  defines  limits  for  the  elevation  -  hydraulic  properties  tables  and  the 
distance  between  interpolated  nodes  (cross  sections).  It  must  appear  before  the  first 
cross  section  (XI)  record,  and  may  be  repeated  before  any  subsequent  cross  section  to 
change  the  tables  or  interpolation  distance. 
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EXAMPLE  PROBLEM  NO.  1 


REACH  NO.  1 
Cross-section  e.CXX) 


Figure  D-2  Typical  Cross  Section  for  Reaches  1  and  4. 


EXAMPLE  PROBLEM  NO.  1 
REACH  NO.  2 
Cross-section  3.999 


Figure  D-3  Typical  Cross  Section  for  Reach  2. 
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EXAMPLE  PROBLEM  NO.  1 
REACH  NO.  3 
Cros«-»*ctlon  3.908 


Figure  D-4  Typical  Cross  Section  for  Reach  3. 


Table  D-1 
CSECT  Input  File 

PR  ON 
T1  REACH  1 

T2  EXAMPLE  NO.  1 

T3  HEC  May  1995 

*  J1  record  required  for  con^atibility  with  PL0T2 . 

♦ 

J1 

*  XK  record  used  to  set  limits  on  elevation  tables  and  disteunce  between 

*  interpolated  cross  sections  for  reach  1.  Elevation  tables  begin  0.01  ft 

*  above  the  channel  bottom  auid  have  twenty  1.25  ft  intervals.  Interpolated 

*  cross  sections  will  be  added  at  0.50  mile  intervals. 

XK  9.99  1.25  .50 

* 

*  Blank  UB  record  specifies  that  the  upstream  boundary  condition  will  be  read 

*  via  the  UNET  input  file.  In  this  problem,  a  flow  hydrograph  is  used. 

UB 

*  NC  record  is  used  to  specify  Manning's  'n'  in  the  overbanks  and  channel. 

* 

NC  .08  .08  .030 


*  XI  and  GR  records  define  the  first  cross  section. 

*  HY  record  used  to  compute  hydrographs. 


XI 

6.0 

8 

100 

145 

5280 

5280 

5280 

HY 

R1  RM 

6.0 

GR 

33 

0 

15 

10 

13 

100 

3 

105 

3 

140 

GR 

13 

145 

15 

240 

33 

250 

XI 

5.0 

8 

100 

145 

5280 

5280 

5280 

GR 

32.5 

0 

14.5 

10 

12.5 

100 

2.5 

105 

2.5 

140 

GR 

12.5 

145 

14.5 

240 

32.5 

250 

XI 

4.0 

8 

100 

145 

HY 

R1  RM 

4.0 

GR 

32 

0 

14 

10 

12 

100 

2 

105 

2 

140 

GR 

12 

145 

14 

240 

32 

250 

*  DB  record  used  to  connect  downstream  boundary  of  reach  1  to  upstream 

*  boundaries  of  reaches  2  zuid  3. 


DB  2  3 

T1  REACH  2 

T2  EXAMPLE  NO.  1 

T3  HEC  May  1995 

*  XK  record  used  to  redefine  elevation  tables  and  interpolated  cross  section 

*  interval.  Tables  reset  to  20  increments  of  1.05  feet.  Cross  section 

*  interpolation  turned  off  due  to  slower  wave  velocities. 
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XK  9.99  1.05  1.0 

UB  1 

* 


XI 

3.999 

8 

50 

90 

2640 

HY 

R2  RM  4. 

.0 

GR 

32 

0 

14 

10 

12 

GR 

12 

90 

14 

120 

32 

*  Last  cross  section  repeated,  elevations 

* 

XI  3.5  5280 

HY  R2  RM  3.5 

* 


2640  2640 

50  2  55  2  85 

130 

lowered  0.25  feet. 

5280  5280  -.25 


*  SA  record  defines  a  storage  area  of  640  acres  {1  sq.mi.). 

*  LA  record  defines  a  lateral  spillway  with  no  gates  between  RM  3 . 5  and  2.5. 

*  WD  record  defines  the  weir  section  of  the  lateral  spillway.  The  weir  is 

*  1/4  mile  long  with  its  midpoint  at  RM  3.0  and  its  average  crest  elevation 

*  equal  to  17.50  ft. 

SA  1  640  0.0  0 

HS  STORAGE  AREA  #1 

LA  1  17.50  0  0  0  0  0  0  0 

WD  1  3.0  17.50  1320 

*  Last  cross  section  repeated,  elevations  lowered  0.50  feet. 

* 

XI  2.5  5280  5280  5280  -.50 

HY  R2  RM  2.5 

* 

*  Last  cross  section  repeated,  elevations  lowered  0.25  feet. 


XI  2.0  -.25 

HY  R2  RM  2.0 
* 


4 


T1  REACH  3 

T2  EXAMPLE  NO.  1 

T3  HEC  May  1995 


*  XI  record  used  to  clumge  cross  section  interpolation  to  1/3  mile  intervals 

*  to  account  for  faster  wave  velocities.  No  change  in  elevation  table  limits. 


XI 

0.33 

UB 

1 

XI 

3.998  8 

50 

70 

10560 

10560 

10560 

HY 

R3  RM  4.0 

GR 

32  0 

14 

10 

12 

50 

2 

GR 

12  70 

14 

120 

32 

130 

*  Last  cross  section  repeated,  elevations  lowered  1.0  feet. 


XI  1.998  -1 

HY  R3  RM  2.0 
* 


DB  4 

T1  REACH  4 

T2  EXAMPLE  NO.  1 

T3  HEC  1995 

*  XI  record  used  to  change  cross  section  interpolation  to  1/5  mile  intervals 

*  to  account  for  faster  wave  velocities.  No  change  in  elevation  table  limits. 

XI  0.2 

* 

*  UB  record  used  to  connect  upstream  boundary  of  reach  4  to  downstream 

*  boxmdaries  of  reaches  2  ^md  3 . 


UB  2  3 

★ 


XI 

1.997 

8 

100 

145 

5280 

5280 

5280 

HY 

R4  RM 

2,0 

GR 

31 

0 

13 

10 

11 

100 

1 

105 

1 

140 

GR 

11 

145 

13 

240 

31 

250 

XI 

1.0 

8 

100 

145 

5280 

5280 

5280 

GR 

30.5 

0 

12.5 

10 

10.5 

100 

.5 

105 

.5 

140 

GR 

* 

10.5 

145 

12.5 

240 

30.5 

250 

XI 

0.0 

8 

100 

145 

52800 

52800 

52800 

HY 

R4  RM 

0.0 

GR 

30 

0 

12 

10 

10 

100 

0 

105 

0 

140 

GR 

10 

145 

12 

240 

30 

250 

*  Last  cross  section  repeated,  elevations  lowered  5.0  feet. 

XI  -10.0  ,5.0 

HY  R4  RM  -10.0 


*  Blank  DB  record  specifies  that  the  downstream  boundary  condition  will  be  read 

*  via  the  UNET  input  file.  In  this  problem,  a  looped  rating  curve 

*  will  be  computed. 

* 

DB 


EJ 


UB  and  DB  records  are  required  for  each  reach  in  the  problem.  These  records 
are  used  to  specify  the  upstream  and  downstream  connections  for  each  reach.  At  flow 


D-10 


Appendix  D  -  Example  Problem  No.  1 


splits,  UNET  applies  a  flow  continuity  equation  for  the  upstream  reach  and  stage 
continuity  equations  for  the  downstream  reaches.  At  flow  combinations,  UNET  applies 
stage  continuity  for  the  upstream  reaches  and  flow  continuity  for  the  downstream  reach. 
Where  a  single  connection  is  specified,  UNET  applies  stage  continuity  equations  at  the 
reach  boundaries.  Since  reach  1  has  no  upstream  connection,  the  UB  record  is  left 
blank.  A  flow  hydrograph  is  specified  as  the  upstream  boundary  condition  in  the  UNET 
input  file.  The  DB  record  connects  reach  1  to  reaches  2  and  3. 

Cross  sections  are  entered  in  HEC-2  forewater  format  i.e.,  in  a  downstream 
direction.  Appendix  E  describes  a  procedure  to  reverse  HEC-2  backwater  data  files  to 
the  forewater  format  required  for  CSECT.  It  also  discusses  additional  data 
requirements  and  formats  specific  to  the  UNET  system.  X1 ,  X3  and  GR  records  are 
used  to  describe  each  cross  section  in  a  manner  similar  to  HEC-2.  HY  records  specify 
locations  for  hydrograph  computation. 

A  second  set  of  title  records  is  used  to  begin  reach  2.  A  UB  record  connects  the 
upstream  boundary  of  reach  2  to  reach  1 .  An  XK  record  is  used  to  change  the  overall 
height  of  the  elevation  tables  to  obtain  improved  resolution  of  the  computed  hydraulic 
properties.  Figure  D-2  compares  elevation  tables  for  reach  1 ,  RM  6.0  and  reach  2,  RM 
4.  Cross  section  interpolation  in  not  used  for  reach  2  due  to  slower  flood  wave 
velocities. 


Table  D-2 

Elevation  Tables  Computed  by  CSECT. 


ICS#  1,  CROSS  SECTION  PROPERTIES  AT  R.M.  6.000 


ELEV 

ALOB 

ACH 

AROB 

AREA 

CLOB 

CCH 

CROB 

CONV 

BAREA 

TW 

SLOB 

SROB 

s 

ALPHA 

BETA 

(ft) 

- (ft 

-2)  — 

< - 

-  xlOOO 

cfs  — 

- > 

(ft"2) 

(ft) 

< - 

(ft-2) 

- > 

< —  coeff  — > 

■k  It  if  it  It  It 

*«***«#* 

******* 

it-kit^itir^ 

***** 

itkkkitkiritit 

******* 

******* 

****** 

**** 

******* 

****** 

******* 

******* 

****** 

3.01 

0. 

0. 

0. 

0. 

0. 

0. 

0. 

0. 

0. 

35. 

0. 

0. 

0. 

1.00 

1.00 

4.26 

0. 

45. 

0. 

45. 

0. 

2. 

0. 

2. 

0. 

36. 

0. 

0. 

0. 

1,00 

1.00 

5.51 

0. 

91. 

0. 

91. 

0. 

8. 

0. 

8. 

0. 

38. 

0. 

0. 

0. 

1.00 

1.00 

6.76 

0. 

139. 

0. 

139. 

0. 

15. 

0. 

15. 

0. 

39. 

0. 

0. 

0. 

1.00 

1.00 

8.01 

0. 

188. 

0. 

188. 

0. 

24. 

0. 

24. 

0. 

40. 

0. 

0. 

0. 

1.00 

1.00 

9.26 

0. 

239. 

0. 

239. 

0. 

34. 

0. 

34. 

0. 

41. 

0. 

0. 

0. 

1.00 

1.00 

10.51 

0. 

291. 

0. 

291. 

0. 

46. 

0. 

46. 

0. 

43. 

0. 

0. 

0. 

1.00 

1.00 

11.76 

0. 

345. 

0. 

345. 

0. 

58. 

0. 

58. 

0. 

44. 

0. 

0. 

0. 

1.00 

1.00 

13.01 

0. 

400. 

0. 

400. 

0. 

72. 

0. 

72. 

0. 

46. 

0. 

0. 

0. 

1.00 

1.00 

14.26 

36. 

457. 

38. 

530. 

0. 

90. 

1. 

91. 

0. 

162. 

0. 

0. 

0. 

1.30 

1.14 

15.51 

136. 

513. 

144. 

792. 

3. 

109. 

3. 

116. 

0. 

231. 

0. 

0. 

0. 

1.99 

1.38 

16.76 

249. 

569. 

263. 

1082. 

9. 

130. 

10. 

149. 

0. 

232. 

0. 

0. 

0. 

2.43 

1.49 

18.01 

363. 

625. 

383  . 

1372. 

17. 

152. 

18. 

187. 

0. 

233. 

0. 

0. 

0. 

2.64 

1.52 

19.26 

478. 

682. 

505. 

1665. 

26. 

176. 

28. 

230. 

0. 

235. 

0. 

0. 

0. 

2.72 

1.53 

20.51 

594. 

738. 

627. 

1959. 

37. 

201. 

39. 

277. 

0. 

236. 

0. 

0. 

0. 

2.73 

1.51 

21.76 

711. 

794. 

750. 

2255. 

50. 

227. 

52. 

329. 

0. 

238. 

0. 

0. 

0, 

2.72 

1.50 

23.01 

829. 

850. 

874. 

2553. 

63. 

254. 

67. 

385. 

0. 

239. 

0. 

0. 

0. 

2.69 

1.48 

24.26 

947. 

907. 

999. 

2852. 

78. 

283. 

83. 

444. 

0. 

240. 

0. 

0. 

0, 

2.66 

1.47 

25.51 

1067. 

963. 

1124. 

3154. 

95. 

313. 

100. 

508. 

0. 

242. 

0. 

0. 

0. 

2.63 

1.46 

26.76 

1187. 

1019. 

1251. 

3457. 

112. 

344. 

119. 

574. 

0. 

243. 

0. 

0. 

0. 

2.60 

1.44 

28.01 

1308. 

1075. 

1378. 

3761, 

131. 

376. 

138. 

645. 

0. 

244. 

0. 

0. 

0. 

2.57 

1.43 

ICS#  4 , 

CROSS  SECTION 

PROPERTIES 

AT  R.M. 

3.999 

ELEV 

ALOB 

ACH 

AROB 

AREA 

CLOB 

CCH 

CROB 

CONV 

BAREA 

TW 

SLOB 

SROB 

s 

ALPHA 

BETA 

(ft) 

(ft-2) 

**** 

***** 

****** 

****** 

********* 

******** 

***** 

****** 

**** 

******* 

******* 

****** 

#**** 

2.01 

0. 

0. 

0. 

0. 

0. 

0. 

0. 

0. 

0. 

30. 

0. 

0. 

0. 

1.00 

1.00 

3.06 

0. 

32. 

0. 

32, 

0. 

2. 

0. 

2. 

0. 

31. 

0. 

0. 

0. 

1.00 

1.00 

4.11 

0. 

66. 

0. 

66. 

0. 

5. 

0. 

5. 

0. 

32. 

0, 

0, 

0. 

1.00 

1.00 

5.16 

0. 

100. 

0. 

100. 

0. 

10, 

0. 

10. 

0. 

33. 

0. 

0. 

0. 

1.00 

1.00 

6.21 

0. 

13  5. 

0. 

13  5. 

0. 

15. 

0. 

15, 

0. 

34. 

0, 

0. 

0. 

1.00 

1.00 

7.26 

0. 

172. 

0. 

172. 

0. 

22. 

0. 

22. 

0. 

35. 

0. 

0. 

0. 

1.00 

1.00 

8.31 

0. 

209. 

0. 

209. 

0, 

29. 

0. 

29. 

0. 

36. 

0. 

0. 

0. 

1.00 

1.00 

9.36 

0. 

248. 

0. 

248. 

0. 

37. 

0. 

37. 

0. 

37. 

0. 

0. 

0. 

1.00 

1.00 

10.41 

0. 

288. 

0. 

288. 

0. 

46. 

0. 

46. 

0. 

38. 

0. 

0. 

0. 

1.00 

1.00 

11.46 

0, 

329. 

0. 

329. 

0. 

56. 

0. 

56. 

0. 

39. 

0. 

0. 

0. 

1.00 

1.00 

12.51 

3. 

370. 

2. 

375. 

0. 

68. 

0. 

68. 

0. 

58. 

0. 

0. 

0. 

1.02 

1.01 

13.56 

24. 

412. 

18. 

455. 

0. 

81. 

0. 

82. 

0. 

95. 

0. 

0. 

0. 

1.19 

1.09 

14.61 

65. 

454. 

48. 

567. 

2. 

95. 

1. 

98. 

0. 

111. 

0. 

0. 

0. 

1.43 

1.18 

15.66 

107. 

496. 

81. 

684. 

4. 

110. 

3. 

117. 

0. 

112. 

0. 

0. 

0. 

1.60 

1.24 

16.71 

150. 

538. 

113. 

802. 

6. 

126. 

5. 

137. 

0. 

113. 

0. 

0. 

0. 

1.72 

1.28 

17.76 

194. 

580. 

147. 

921. 

10, 

143. 

7  . 

160. 

0. 

114. 

0. 

0. 

0. 

1.81 

1.30 
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18.81 

239. 

622. 

181. 

1042. 

19.86 

284. 

664. 

215. 

1164. 

20.91 

330. 

706. 

251. 

1287. 

21.96 

376. 

748. 

286. 

1411. 

23.01 

423. 

790. 

323. 

1536. 

13. 

161. 

10. 

184. 

0. 

115 

18. 

179. 

13. 

210. 

0. 

117 

22. 

‘198. 

16. 

237. 

0. 

118 

27. 

218. 

20. 

265. 

0. 

119 

32. 

239. 

24. 

296. 

0. 

120 

0. 

0. 

0. 

1.88 

1.32 

0. 

0. 

0. 

1.93 

1.33 

0. 

0. 

0. 

1.97 

1.34 

0. 

0. 

0. 

2.00 

1.34 

0. 

0. 

0. 

2.03 

1,35 

The  storage  area  is  defined  by  an  SA  record,  where  a  size  of  640  acres  (1 
sq.mi.)  is  specified.  The  LA  record  defines  a  lateral  "spillway"  along  the  channel 
between  miles  3.5  and  2.5.  The  spillway  crest  elevation  is  17.5  feet  and  has  no  gated 
sections  (WSP  =  0  in  Field  3).  When  no  gates  are  specified,  the  entire  "spillway"  length 
is  assumed  to  be  a  side  channel  weir.  A  WD  record  defines  the  weir  to  be  1 320  feet  in 
length  with  a  crest  elevation  of  17.5  feet.  For  this  "spillway",  equation  4-18  reduces  to: 


Q^=CWm  (D-1) 

where:  C  =  weir  discharge  coefficient  =  3.0, 

W  =  weir  width  =  1320  feet, 

H  =  (average  spillway  water  surface  elevation)  -  (weir  crest  elevation), 
n  =  1.5. 

The  DB  record  connects  the  downstream  boundary  of  reach  2  to  reach  4.  Reach 
3  is  identical  to  reach  4  except  for  the  storage  area. 

Reach  4  is  connected  to  reaches  2  and  3  via  a  UB  record.  A  blank  DB  record  is 
used  at  the  downstream  end  of  reach  4.  A  downstream  boundary  condition  (specified 
in  the  UNET  input  file)  is  required  to  complete  the  input  file.  Although  the  study  area 
ends  at  river  mile  0.0,  a  final  cross  section  is  added  10  miles  further  downstream  to 
apply  the  boundary  condition.  This  technique  is  described  in  section  D.2. 

CSECT  assigns  node  numbers  to  both  input  (ICS)  and  interpolated  cross 
sections  and  resolves  all  connections  between  the  reaches.  Figure  D-3  is  the  reach 
connection  table,  while  Figure  D-4  shows  the  node  number  assignments  for  input  cross 
sections  in  the  four  reaches.  Both  Figures  are  standard  in  all  CSECT  output  files. 


Table  D-3 

CSECT  Reach  Connection  Table. 

10APR95  11:24:55 


REACH 

CONNECTION  TABLE 

REACH 

ICSU 

NODEU 

ICSD 

NODED 

lUSTYP 

NUCON  1  IRCH 

***** 

*♦♦♦ 

***** 

**** 

***** 

****** 

****  ****  ****  **1 

1 

1 

1 

3 

5 

1 

0 

0 

2 

4 

6 

7 

9 

3 

5 

1 

3 

8 

10 

9 

16 

3 

5 

1 

4 

10 

17 

13 

77 

2 

9  16 

IDSTYP 

5 

6 
6 


NDCON 


6 
2 
17 
4 
17 
4 

0  0 


10 

3 
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Table  0-4 

CSECT  Node  Assignments. 

10APR95  11:24:55 

^  -i  u 

NODE  LOCATIONS  FOR  REACH  1 

PAGE  16 

SECNAM  RM  ICS  NODE 

SECNAM  RM  ICS  NODE  SECNAM  RM  ICS  NODE 

**  ***  ****  ******  **  ***  **** 

SECNAM  RM 

******  ** 

ICS  NODE 
***  **** 

6.0  6.00 


5.0  5.00  2  3  4.0  4.00  3  5 
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NODE  LOCATIONS  FOR  REACH  2 


SECNAM 

RM  ICS 

NODE 

SECNAM 

RM 

ICS 

*** 

NODE 

**** 

SECNAM 

RM 

ICS  NODE 

SECNAM 

RM 

*★ 

ICS 

NODE 

3.999 

4.00  4 

6 

3.5 

3.50 

5 

7 

2.5 

2.50 

6  6 

2.0 

2.00 

7 

9 

NODE 

;  LOCATIONS 

FOR  REACH  3 

SECNAM 

RM  ICS 

NODE 

SECNAM 

RM 

ICS 

NODE 

SECNAM 

RM 
*  * 

ICS  NODE 

*  *  *  *  •  *  * 

SECNAM 

****** 

RM 
*  ★ 

ICS 

NODE 

3.998 

4.00  8 

10 

1.998 

2.00 

9 

16 

NODE 

LOCATIONS 

FOR  REACH  4 

SECNAM 

****** 

RM  ICS 

NODE 

SECNAM 

RM 

ICS 

NODE 

SECNAM 

****** 

RM 
*  * 

ICS  NODE 

SECNAM 

****** 

RM 

ICS 

NODE 

1.997 

10APR95 

11 

2.00  10 
.:24:55 

17 

1.0 

1.00 

11 

22 

0.0 

0.00 

12  27 

-10.0 

-10.00 

13  77 

PAGE  17 

IN-LINE 

AND  LATERAL  SPILLWAYS 

NO  IBCTYP 
**  ****** 

NIIBC  SECNAM 
*****  ****** 

N2IBC  NCONN 

*****  ***** 

CE 

WSP 
**  * 

ZSP  BE 

HE 

** 

CWEIR  ZWEIR 

WEIRL 

***** 

1 

3 

7 

3.5 

7 

1 

0.00 

0 

.00  17.50  1.00 

0.00 

3.00  17.50  : 

1320.00 

10APR95  11:24:55  PAGE  18 

SUGGESTED  INITIAL  STORAGE  AREA  ELEVATIONS 
NO  ZSA 

1  0.00 

10APR95  11:24:55  PAGE  19 

STORAGE  AREAS 

NO  SA  NODE  SUR  AR  ZMIN  ZSPMIN  CONNECTING  NODES 

11  7  640.  0.00  0.00 

D.2  UNET  Input  File 

Figure  D-5  is  the  UNET  input  file  for  this  problem.  After  CSECT  has  created  the 
elevation  -  hydraulic  property  tables  and  computed  reach  connections,  the  unsteady 
flow  calculations  can  proceed.  It  is  not  necessary  to  rerun  CSECT  unless  changes  are 
made  to  the  CSECT  input  file.  The  UNET  input  file  contains  program  instructions  and 
data  required  by  the  RDSS,  UNET  and  TABLE  programs.  This  information  includes: 
boundary  condition  data  stored  in  DSS  pathnames,  program  control  "switches"  and 
variables,  directly  entered  boundary  and  initial  conditions,  and  specifications  required  to 
write  computed  results  to  DSS  files.  Appendix  C  provides  detailed  descriptions  for  all 
input  to  UNET. 

A  UNET  input  file  consists  of  three  title  records  followed  by  a  series  of 
"command"  records  and  associated  "parameter"  records.  The  command  records 
contain  significant  CAPITALIZED  characters  which  specify  specific  routines  to  be 
performed.  Additional  text  can  be  added,  which  is  a  convenient  self-documenting 
feature.  Immediately  following  most  command  records,  parameter  records  pass 
specific  variable  assignments  to  the  program  routines.  Title  and  comment  records 
should  begin  with  an  asterisk  and  a  space. 


Table  D-5 
UNET  Input  File. 

*  EXAMPLE  1 

*  TRIANGULAR  HYDROGRAPH  WITH  A  10000  CPS  CREST 

*  BC  at  RM-10 

*  The  first  three  lines  should  always  be  title  records. 

*  In  all  command  records,  the  significant  characters  are 

*  capitalized.  Refer  to  Appendix  C  for  details  on  all 

*  records  used. 
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JOb  control 

T  T  15MIN  48-1  F  0.8  F  T  -1  15MIN 

*  Print  initial  conditions.  ‘ 

*  Write  maximum  water  surface  profiles  to  DSS. 

*  Times tep  dT  *  15  min. 

*  Duration  of  r\in  »  0  (overidden  by  Time  WINDOW)  . 

*  No  instantaneous  flow  and  stage  profiles  written  to  DSS. 

*  Levee  routines  disabled. 

*  Implicit  weighting  factor  theta  ■  0.8,  based  on  previous 

*  sensitivity  analysis. 

*  This  option  not  yet  developed. 

*  Print  flow  and  stage  at  HY  nodes  and  spillway/weir  flows  at 

*  each  timestep. 

*  No  initial  conditions  file  written. 

*  15min  DSS  interval  for  computation  of  hydrographs. 

*  Set  time  period  for  simulation  (not  required  when  all 

*  boxmdary  condition  data  will  be  read  from  a  DSS  file) . 

Time  WINDOW 

01APR1991  0800  03APR1991  0800 


WRite  hydrographs  to  dss  (.DSS  filetype  added  to  filename) 
Probleml 


*  Enter  a  hydrograph  as  the  upstream  boundary  condition.  The 

*  format  used  is: 

*  Reach  #,  #  of  data  points  in  hydrograph 

*  Time  i.  Flow  i, 

*  ^  Time  i+1.  Flow  i+1,  etc. 

*  Linear  interpolation  is  used  between  entered  data. 

* 

UPSTREAM  FLOW  hydrograph  boundary  condition  at  RM  4,  reach  1 
1  4 

0  1000 
15  10000 
30  1000 
48  1000 


*  A  looped  rating  curve  will  be  computed  for  use  as  the 

*  downstream  boundary  condition.  Note;  errors  may  be  introduced 

*  into  the  solution  near  this  boundary  as  the  approximation 

*  can  be  inaccurate.  This  error  can  be  eliminated  by  moving 

*  the  condition  further  downstream.  The  condition  will 

*  be  applied  10  miles  downstreeim  from  the  end  of  the  study  area. 

Downstream  MANNING'S  equation  applied  at  RM  -10,  reach  4. 

4  .0000947 


*  Initial  flows  in  all  reaches  are  required  to  start  the 

*  calculations.  The  format  is;  Reach  i.  Flow  i,  etc. 

* 

INITIAL  FLOW  distribution  based  on  previous  steady  flow  run. 
4  1000 
3  290 
2  710 
1  1000 

*  Initial  water  surface  elevations  are  required  for  all 

*  storage  areas.  The  format  is: 

*  Storage  area  i,  water  surface  elevation  i,  etc. 

* 

INITIAL  STORAGE  area  elevation 
1  10 


*  Individually  defined  parameters.  For  this  problem,  weir 

*  flow  parameters  are  defined  for  the  weir  in  Reach  2.  A  non- 

*  linear  solution  will  be  used,  so  the  meucimum  #  of  iterations 

*  and  a  flow  convergence  error  criterion  is  required  by  the 

*  Newton-Raphson  iterative  solution  scheme. 

WFSTAB  s  3-0 
WFX  =2.0 
MXITER  =20 
QTOL  =  5 

*  An  end  of  job  record  must  be  at  the  bottom  of  all  files. 

EJ 


After  the  title  records,  the  job  control  parameters  are  specified.  The 
computational  time  step  (DT)  is  entered  and  the  DSS  interval  for  computed 
hydrographs  is  entered  as  character  data.  Only  valid  DSS  intervals  (HEC,  1 990b)  are 
permitted  and  must  be  selected  greater  than  or  equal  to  the  computational  time  step. 

The  time  window  specifies  the  simulation  period.  It  is  required  whenever  time 
series  data  is  directly  entered  in  the  UNET  input  file  to  specify  a  boundary  condition. 
Computed  hydrographs  and  profiles  are  written  to  the  DSS  file  "PROBLEM  1". 

An  upstream  boundary  condition  is  required  for  each  reach  with  a  blank  UB 
record  in  the  CSECT  input  file.  Similarly,  a  downstream  boundary  condition  is  required 
for  reaches  with  blank  DB  records  in  the  CSECT  input  file.  For  this  problem,  reaches  1 
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and  4  meet  this  criteria.  Boundary  conditions  must  be  specified  to  span  the  entire 
simuiation  time.  A  fiow  hydrograph  is  specified  expiicitiy  with  a  series  of  time-discharge 
(hr-ft7s)  pairs.  Note  that  time  0  is  equivaient  to  8:00  am,  Aprii  1 , 1991 .  Discharge 
vaiues  are  iineariy  interpoiated  between  data  points.  This  exampie  shows  the  simpiest 
method  to  input  a  hydrograph.  Other  methods,  inciuding  reading  boundary  conditions 
from  DSS,  are  described  in  Appendix  C. 

A  iooped  rating  curve  is  applied  at  the  downstream  boundary  of  reach  4.  The 
initial  friction  slope  is  set  equal  to  the  bed  slope  and  is  recomputed  at  each  time  step. 
The  friction  slope  is  then  used  in  Manning's  equation  to  solve  for  stage  based  on  the 
current  discharge.  As  described  in  Appendix  C,  this  boundary  condition  only  provides  a 
rough  approximation  of  the  actual  unsteady  flow  rating  curve;  therefore,  errors  can  be 
introduced  into  the  solution.  A  simple  technique  for  eliminating  these  errors  is  to  apply 
the  boundary  condition  further  downstream.  In  this  example,  ten  miles  of  stream  have 
been  added  to  reach  4  in  the  CSECT  input  file,  and  the  boundary  condition  is  applied  at 
river  mile  -10.  The  penalty  for  applying  this  procedure  is  an  increase  in  computer 
solution  time,  as  fifty  interpolated  cross  sections  are  added  to  the  system. 

Initial  conditions  of  flow  and  stage  are  provided  at  each  cross  section,  as  is  the 
initial  water  surface  elevation  in  the  storage  area.  The  initial  flow  distribution  is 
specified  from  downstream  to  upstream  for  each  reach.  UNET  performs  a  step- 
backwater  analysis  to  compute  the  initial  water  surface  profile.  In  this  problem,  the 
initial  flows  are  the  result  of  a  previous  steady  flow  simulation.  An  initial  guess  of  the 
flow  distribution  was  used  (Q1  =  Q4  =  1000  ft%,  Q2  =  200  ft^s,  Q3  =  800  ft^/s)  and  the 
model  was  run  until  steady  state  conditions  occurred.  These  values  (Q2  =  290  ft®/s,  Q3 
=  710  ft^/s)  were  then  used  in  the  unsteady  flow  simulation.  This  procedure  eliminates 
errors  due  to  non-steady  state  initial  conditions. 


Depending  on  the  problem,  additional  numerical  parameters  may  be  necessary 
to  control  the  unsteady  flow  solution  or  to  fine  tune  specific  computations.  Default 
values  are  listed  on  pages  5  and  6  of  Appendix  C.  For  this  problem, 


WFSTAB  =  3.0, 
WFX  =  2.0, 
MXITER  =  20, 

QTOL  =  5  nVs, 


Weir  flow  stability  factor 

Weir  flow  submergence  exponent 

Maximum  #  of  iterations  in  the  nonlinear  Newton- 

Raphson  solution  scheme 

Discharge  convergence  error  criterion  for  Newton- 

Raphson 


WFSTAB  and  WFX  affect  the  solution  of  weir  flow  equations.  The  default  value  for 
MXITER  is  0,  i.e.,  a  linearized  solution  method  will  be  performed.  Although  this  scheme 
may  be  faster  than  the  nonlinear  scheme,  the  linearization  of  terms  in  the  unsteady  flow 
solution  matrix  may  result  in  less  accurate  solutions. 


D.3  Results 


Figure  D-5  compares  inflow  hydrographs  at  the  upstream  boundary,  river  mile 
6.0.  The  error  introduced  by  placing  the  downstream  boundary  condition  at  river  mile 
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0.0  influences  stage  results  over  the  entire  length  of  the  system.  Figure  D-6  compares 
hydrographs  for  the  flow  split  at  river  mile  4.0.  Due  to  the  wider  channel,  reach  2 
conveys  a  larger  portion  of  the  total  flow  than  reach  3. 

Figure  D-7  compares  hydrographs  on  either  side  of  the  weir  and  storage  area  in 
reach  2.  Once  water  begins  to  spill  into  the  storage  area,  stage  below  the  weir  remains 
nearly  constant  until  the  water  level  in  the  storage  area  equals  that  in  the  channel.  Flow 
in  the  channel  below  the  weir  drops  to  nearly  zero  as  most  of  the  water  flows  into  the 
storage  area,  then  increases  again  as  the  storage  area  water  surface  begins  to 
equalize  with  that  in  the  channel. 

Figure  D-8  compares  hydrographs  for  the  flow  combination  at  river  mile  2.0, 
Again,  when  water  is  spilling  into  the  storage  area,  flow  in  reach  2  drops  to  nearly  zero. 
At  that  time,  flow  in  reaches  3  and  4  are  equal,  verifying  that  continuity  is  being 
maintained. 

Figure  D-9  compares  two  sets  of  maximum  water  surface  profiles,  showing  the 
effect  of  location  of  the  downstream  boundary  condition.  Recall  that  the  study  area  is 
composed  of  reach  1  (river  mile  6.0  to  4.0),  reaches  2  and  3  (4.0  to  2.0),  and  reach  4 
(2.0  to  0.0).  The  dashed  line  is  the  profile  computed  when  the  downstream  boundary  is 
placed  at  river  mile  0.0,  while  the  solid  line  is  the  profile  computed  when  the  boundary  is 
moved  ten  miles  away  from  the  study  area.  The  difference  in  profiles  can  be 
understood  by  considering  Figure  D-10.  This  figure  compares  rating  curves  computed 
at  river  mile  0.0.  The  dashed  curve  is  the  downstream  boundary  condition  applied  at 
river  mile  0.0.  It  is  essentially  a  single-valued,  monotonically  increasing  relationship, 
typical  of  steady,  uniform  flow  conditions.  The  solid  curve  results  when  the  boundary 
condition  is  relocated  ten  miles  downstream,  and  represents  the  looped  curve 
characteristic  of  the  channel  at  river  mile  0.0.  Note  that  maximum  stage  for  the  dashed 
curve  is  higher  than  the  stage  for  the  same  flow  on  the  solid  curve.  This  error  can  be 
seen  at  river  mile  0.0  in  Figure  8.14.  For  this  problem,  the  error  is  shown  to  impact  the 
results  for  the  entire  six  miles  of  channel  (recall  Figure  D-5). 

When  applying  this  type  of  downstream  boundary  condition  away  from  the  study 
area,  the  actual  geometry  of  additional  cross  sections  should  be  used.  The  prismatic 
channel  used  for  reach  4  allowed  use  of  a  simple  repeat  cross  section.  If  the  added 
reach  length  contains  backwater  effects  such  as  tributary  inflows  or  hydraulic  control 
structures,  they  should  be  included  in  the  model  as  well. 
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EXAMPLE  PROBLEM  #2 
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To  demonstrate  some  of  the  advanced  features  of  the  UNET  program,  a  model 
was  developed  of  the  diamond  shape  that  is  shown  in  Figure  D-1 1 .  The  system 
consists  of  8  reaches  and  4  storage  areas  that  are  interconnected.  The  hydraulic 
structures  in  the  system  include;  culverts,  a  pump  diversion,  riser  pipes,  a  lateral 
spillway,  weirs,  and  a  bridge.  The  geometry  file  is  shown  in  Table  D-6  and  the 
boundary  condition  file  is  shown  in  Table  D-7. 
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Table  D-6 

Geometry  File  for  the  Diamond  Shaped  System. 

PR  ON 

T1  REACH  1 

T2  SFWMD  DIAMOND 

T3  BARKAU  APRIL  1991 
* 

*  XK  record  is  used  to  define  hydraulic  table  limits  and  cross-section 

*  interpolation. 


XK  50 

XI  .25 

★ 

1.5 

1 

UB 

* 

00 

o 

.08 

.030 

XI  6.0 

8 

100 

145 

5280 

5280 

5280 

HY  1  RM  6.0 
GR  33 

0 

15 

10 

13 

100 

3 

105 

3 

GR  13 

★ 

145 

15 

240 

33 

250 

XI  5.0 

HY  1  RM  5.0 

8 

100 

145 

5280 

5280 

5280 

X3 

30 

999 

220 

-999 

GR  32.5 

0 

14.5 

10 

12.5 

100 

2.5 

105 

2.5 

GR  12.5 
★ 

145 

14.5 

240 

32.5 

250 

XI  4.0 

8 

100 

145 

HY  1  RM  4.0 
GR  32 

0 

14 

10 

12 

100 

2 

105 

2 

GR  12 

145 

14 

240 

32 

250 

*  Downstream  Boundary  of  reach  1  connects  to  reach  2  and  5 . 


140 


140 


140 


DB  2  5 

* 

T1  REACH  2 
T2  SFWMD  DIAMOND 

T3  BARKAU  APRIL  1991 
* 

*  Upstream  Boundary  of  reach  2  connects  to  reach  1 . 


UB 

* 

1 

XI 

4.0 

8 

50 

90 

2640 

2640 

2640 

HY 

2  RM  4.0 

GR 

33 

0 

14 

10 

12 

50 

2 

55 

2 

GR 

* 

12 

90 

14 

120 

33 

130 

★ 

The  next 

record  is 

a  Pump 

Diversion. 

Water  is 

diverted 

from  reach 

2, 

*  river  mile  4.0,  into  storage  area  number  1.  The  p\imp  is  turned  on  at 

*  elevation  23  and  off  when  the  water  drops  down  to  elevation  21.  The 

*  flow  rate  of  pumping  is  100  cfs. 


PD  2  4.0  -1  1  23  21  100 

XI  3.496  3900  3900  3900  -.25 

★ 

*  The  default  for  the  program  is  to  use  a  family  of  rating  curves,  rather 

*  than  exponential  equations  (not  recommended) ,  for  the  following  bridge  and 

*  culverts.  To  use  the  exponential  equations  apply  an  FA  OFF  command,  e.g. 

* 


*  FA  OFF 

★ 


XI 

3.400  8 

50 

65 

50 

50 

50 

-.25 

HY 

RCH  2  SEC  3.40 

X3 

55 

20 

60 

20 

GR 

33  0 

14 

10 

12 

50 

3 

55  3  60 

GR 

* 

3  65 

14 

120 

33 

130 

★ 

The  next  three 

records 

desribe 

a  circular 

culvert 

crossing, 

between  sections 

★ 

3.4  and  3.39. 
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CC  6 

3 

3 

30 

.025 

7 

0 

WD  1 

3.0 

20 

100 

i 

CL 

♦ 

XI  3.390 

4000 

4000 

4000 

HY  RCH  2  SEC 

3.39 

X3 

55 

20 

60 

20 

* 


XI  2.0  ^75 

HY  2  RM  2.0 


*  The  downstream  boundary  of  reach  2  connects  to  reaches  3  and  4. 

* 

DB  3  4 

* 

T1  REACH  3 
T2  SFWMD  DIAMOND 

T3  BARKAU  APRIL  1991 
* 

*  The  upstream  boundary  of  reach  3  connects  to  reach  2 . 


UB  2 
* 


XI  1.0 

HY  3  RM  1.0 

8 

50 

90 

5280 

5280 

5280 

-.75 

GR  33 

0 

14 

10 

12 

50 

2 

55 

2 

85 

GR  12 

90 

14 

120 

33 

130 

* 


*  The  next  four  records  describe  two  storage  areas  located  in  the  center  of 

*  the  diamond  shaped  reaches. 


SA  1  1000  0  3  6 

HS  CENTER  LAKE 
SA  2  1000  0 

HS  SECOND  LAKE 
★ 

*  The  following  SC  record  defines  a  "Special  Connection"  in  the  stream  network. 

*  Special  connections  can  be  defined  between  two  storage  areas  or  from  a 

*  river  reach  to  a  storage  area.  The  next  four  records  describe  a  special 

*  connection  between  storage  area  1  and  2.  The  connection  is  defined  with  a 

*  riser  pipe  and  a  weir. 


SC 

-1 

-2 

RI 

5 

2.6 

2.5 

50 

.022 

7  2.4  11.5 

16 

WD 

1 

2.5 

16.5 

500 

RL 

* 

20 

20 

11.5 

19 

11.6 

19.2 

XI 

* 

0.0 

7900 

7900  7900 

-.75 

* 

The  downstream 

boundary 

of  reach 

3  is 

storage  area  number  1. 

* 


DB  -1 
* 

T1  REACH  4 
T2  SFWMD  DIAMOND 

T3  BARKAU  APRIL  1991 
* 

*  The  upstream  boundary  of  reach  4  is  reach  2 

★ 

UB  2 


XI 

to 

o 

8 

50 

90 

500 

500 

500 

-.75 

HY  4 

RM  2.0 

GR 

33 

0 

14 

10 

12 

50 

2 

55 

2 

85 

GR 

12 

90 

14 

120 

33 

130 

*  The  next  four  records  describe  storage  areas  3  and  4 . 

★ 

SA  3  1000 

HS  THIRD  LAKE 
SA  4  1000 

HS  FOURTH  LAKE 
★ 

*  The  LA  and  WD  records  are  used  to  describe  a  lateral  weir  from  reach  4  into 
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Storage  area  number  4. 


WD  1 

★ 

3 

10 

50 

*  The  next 

four 

records 

describe 

a  "special 

connection" 

between 

storage  area 

*  3  and  4 . 

* 

The 

connection  is  a 

riser  pipe 

and 

a  weir. 

SC  ~3 

-4 

RI  5 

2.6 

2.5 

50 

.022 

7 

2.4 

14 

16 

WD  1 

RL 

* 

2.5 

16.5 

500 

XI  1.9 

8 

50 

90 

10000  10000 

10000 

-.75 

HY  4  RM  2.0 
GR  33 

0 

14 

10 

12 

50 

2 

55 

2  85 

GR  12 

★ 

XI  0.0 

HY  4  RM  0.0 

90 

14 

120 

33 

130 

-2.0 

*  The  downstream  boundary  of  reach  4  is  reach  8 . 

★ 

DB  8 

* 

T1  REACH  5 
T2  SFWMD  DIAMOND 

T3  BARKAU  APRIL  1991 
★ 

*  The  upstream  boundary  of  reach  5  is  reach  1. 

★ 

UB  1 


XI 3 
HY 

.9999 

5  RM  5.0 

8 

50 

70 

10560 

10560 

GR 

33 

0 

14 

10 

12 

50 

GR 

12 

70 

14 

120 

33 

130 

XI  2.0 
HY  5  RM  2.0 
* 

*  The  downstream  boundary  of  reach  5  is  reach  6  and  7. 

* 

DB  6  7 

* 

T1  REACH  6 

T2  SFWMD  DIAMOND 

T3  BARKAU  APRIL  1991 
* 

*  Upstream  boundary  of  reach  6  is  reach  5. 

* 

UB  5 


XI  1,0 
HY  6  RM  1.0 
GR  33 

GR  12 

■k 

XI  0.0 
HY  6  RM  0.0 


*  Downstream  boundary  of  reach  6  is  storage  area  number  1. 

* 

DB  -1 
★ 

T1  REACH  7 
T2  SFWMD  DIAMOND 
T3  BARKAU  APRIL  1991 
★ 

*  Upstream  boundary  of  reach  7  is  reach  5. 

* 

UB  5 
★ 

XI  2.0  8  50  70  560  560  560 


8 

50 

70 

10560 

10560 

10560 

-1 

0 

14 

10 

12 

50 

2 

55 

2 

65 

70 

14 

120 

33 

130 
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0  14  10  ^  12  50  2  55  2  65 

70  14  120  33  130 


*  The  next  four  records  describe  a  special  connection  from  rech  7  to  storage 

*  area  niimber  2.  The  special  connection  is  a  circular  culvert.  The  culvert 

*  only  allows  flow  to  go  from  storage  area  2  into  reach  7.  This  is  controlled 

*  by  field  seven  of  the  CC  record. 

* 


sc 

-2 

CC 

6 

8 

WD 

1 

2.5 

CL 

★ 

XI 

1.9 

HY 

7 

RM  1.9 

* 

XI 

o 

o 

HY 

7 

RM  0.0 

* 


20  .022  7  -1 

100 


10000  10000  10000 


-2 


*  The  downstream  boundary  of  reach  7  is  reach  8. 


DB  8 

★ 


T1  REACH  8 
T2  SFWMD  DIAMOND 

T3  BARKAU  APRIL  1991 
-* 

*  The  upstream  boundary  of  reach  8  is  reach  4  and  7. 

★ 

UB  4  7 


*  The  next  four  cross  sections  area  used  with  the  special  bridge  option, 

*  The  special  bridge  option  (BR  record)  allows  the  flow  to  transition  between 

*  low  flow,  pressure  flow,  and  pressure  and  weir  flow. 

* 


*  FULL  WIDTH  CROSS-SECTION 

* 


XI  2.0 

8 

100 

145 

150 

150 

150 

-1 

HY  8  RM  2. 

0 

GR  31 

0 

13 

10 

11 

100 

1 

105 

1 

140 

GR  11 

* 

145 

13 

240 

31 

250 

*  UPSTREAM 

* 

CONSTRICTED  CROSS* 

-SECTION 

XI  1.90 

8 

100 

145 

50 

50 

50 

X3 

70 

999 

170 

999 

GR  15 

0 

15 

100 

11 

100 

1 

105 

1 

140 

GR  11 

* 

145 

15 

145 

15 

250 

*  BRIDGE  DATA 


BR 

1.2 

10 

1.6 

.8 

11 

15 

3.0 

WD 

1 

3 

15 

100 

BL 

* 

28 

29 

7 

*  DOWNSTREAM 

* 

CONSTRICTED 

CROSS-SECTION 

XI 

1.89 

8 

100 

145 

600 

600 

600 

X3 

70 

999 

170 

999 

GR 

15 

0 

15 

100 

11 

100 

1 

105 

1 

140 

GR 

* 

11 

145 

15 

145 

15 

250 

*  FULL  WIDTH 

* 

CROSS' 

-SECTION 

XI 

1.80 

8 

100 

145 

4500 

4500 

4500 

-1 

HY 

8  RM  2.0 

GR 

31 

0 

13 

10 

11 

100 

1 

105 

1 

140 

GR 

★ 

11 

145 

13 

240 

31 

250 

XI 

1.0 

8 

100 

145 

5280 

5280 

5280 

-1 

GR 

30.5 

0 

12.5 

10 

10,5 

100 

.5 

105 

.5 

140 

GR 

10.5 

145 

12.5 

240 

32.5 

250 
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XI  0.0 

8 

100 

145 

~1 

HY  8  RM  0.0 
GR  30 

0 

12 

10 

10 

100 

0 

105 

0 

140 

GR  10 

145 

12 

240 

30 

250 

* 


*  Reach  8  is  the  end  of  the  model,  therefore  the  downstream  boundary  does 

*  not  connect  to  another  reach  or  storage  area.  The  downstream  boundary 

*  of  reach  8  defined  by  mannings  equation;  i.e.  a  normal  depth  rating. 

*  This  rating  curve  is  defined  in  the  UNET  input  file. 

* 

DB 

★ 

EJ 


Table  D-7 

Boundary  Condition  File  for  the  Diamond  Shaped  System. 

*  EXAMPLE  NO.  1 

*  TRIANGULAR  HYDROGRAPH  WITH  10000  CFS  AS  A  CREST 

*  DIAMOND 

JOB  CONTROL 

T  T  15MIN  48  -1  T  .6  F  T  -1  15MIN 

*  CONTROL  ITERATION 
MXITER=:5 
ZT0L1=.2 
ZSAT0L1= . 2 
ZTOL=.05 
ZSATOL=.05 

TIME  WINDOW 

01JAN1990  0800  03JAN1990  0800 

UPSTREAM  BOUNDARY 
1 
5 

0  100 
12  1000 
15  5000 
30  1000 
50  500 

CRITICAL  UPSTREAM  BOUNDARY 
100 

LATERAL  INFLOW  INTO  STORAGE  AREA  1 
-1 
3 

0  800 
12  1000 
50  800 

LATERAL  INFLOW  INTO  STORAGE  AREA  3 
-3 
5 

0  0 
12  1000 
15  5000 
30  1000 
50  0 

DOWNSTREAM  MANNING'S  EQUATION 
8  .0000947 

INITIAL  STORAGE  AREA  ELEVATIONS 
1  11 
2  10 

3  12 

4  10 

WRITE  HYDROGRAPHS  TO  DSS 
DIAMOND 
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INITIAL  FLOW  DISTRIBUTION 
8  100 
7  20 
6  10 
5  30 
4  60 
3  10 
2  70 
1  100 

EJ 
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EXAMPLE  PROBLEM  #3 
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In  this  example,  flow  in  a  river  with  an  ice  cover  was  modeled.  The  ice  cover 
was  assumed  to  begin  8.5  miles  upstream  from  the  downstream  end  of  the  river  and  to 
extend  along  the  river  for  approximately  4.5  miles.  The  channel  was  a  single  river  reach 
20  miles  long.  The  ice  cover  was  assumed  to  be  1  foot  thick  in  the  left  and  right 
overbanks  and  2  feet  thick  in  the  channel.  The  ice  cover  was  assigned  a  Manning's  n 
value  of  0.07  (a  rather  large  value,  corresponding  to  an  ice  cover  composed  of  rough 
broken  ice  pieces,  for  example),  and  a  specific  gravity  of  0.916  (typical  specific  gravity 
of  freshwater  ice). 

The  initial  flow  rate  was  set  at  500  ft^/s  along  the  entire  length  of  the  river.  After 
approximately  6  hours,  the  flow  rate  entering  the  upstream  end  of  the  river  was 
increased,  and  reached  a  peak  of  about  18,000  ft^/s  18  hours  after  the  start  of  the 
simulation.  The  entering  flow  was  then  decreased  and  reached  about  1800  ft®/s  after  40 
hours  of  simulation.  The  flow  rate  was  then  slowly  decreased  to  1670  ft^/s  over  the  next 
24  hours. 

The  simulation  was  then  repeated.  However,  for  the  second  simulation  the  ice 
cover  was  removed.  This  allowed  the  water  surface  profiles  for  open  water  and  ice 
cover  conditions  to  be  compared,  as  well  as  the  flow  and  stage  hydrographs  at  specific 
cross  sections. 

It  is  important  to  realize  that,  although  UNET  can  model  the  influence  of  a  stable 
ice  cover  on  the  channel  hydraulics,  the  program  will  make  no  determination  as  to  the 
appropriateness  of  the  ice  cover  input  data.  As  is  well  known,  ice  covers  are  only 
'stable'  under  a  limited  range  of  flow  conditions.  A  stable  ice  cover  is  one  that  remains 
in  place  without  failure.  Failure  of  an  ice  cover  is  generally  termed  ‘break-up’.  Break-up 
of  an  ice  cover  can  be  induced  by  an  increase  in  the  flow  rates  in  the  channel,  a 
weakening  of  the  ice  cover  through  the  input  of  heat,  or  perhaps  by  other  means. 

UNET  will  make  no  judgments  regarding  the  stability  of  the  ice  cover  being  modeled, 
and  it  is  up  to  the  user  to  decide  if  the  ice  cover  will  be  stable  under  the  range  of 
hydraulic  conditions  modeled. 

CSECT  Input  File 

Table  D-8  is  the  CSECT  input  file  for  this  problem.  Appendix  B  contains  detailed 
descriptions  of  each  input  record.  The  ice  cover  is  described  using  an  1C  record.  Note 
that  the  ice  cover  starts  at  cross  section  #5  and  extends  to  cross  section  #8.  It  is 
important  to  note  that  cross  section  #8  is  considered  to  be  ice  free.  The  ice  cover 
information  supplied  by  each  1C  record  is  assumed  to  start  at  the  first  cross  section 
down  stream  of  the  1C  record.  The  ice  cover  will  be  assumed  to  exist  at  all  nodes 
interpolated  between  cross  section  #5  and  cross  section  #8. 

To  remove  the  ice  cover  for  the  second  simulation,  the  1C  lines  in  the  CSECT 
input  file  were  simply  commented  out  by  placing  an  asterisk  at  the  start  of  the  line. 
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Table  D-8 
CSECT  Input  File. 

PR  ON 

T1  ST. R. REACH 
T2  ICE  EXAMPLE 
T3  HEC 
UB 
★ 

NC  .07  .07  .03 

* 

*  ICE  DATA  FOR  STRAIGHT  RIVER  REACH 

*IC  1.0  1.0  2.0  .07 

* 

*  CROSS-SECTION  1 

* 


XK 

9.99 

1.25 

.3 

XI 

20.00  8 

370 

470 

13200 

13200 

13200 

HY 

RCHl  SECl 

ZO 

938 

GR 

1000  0.0 

950 

20 

948 

370 

938 

380 

938 

460 

GR 

★ 

948  470 

950 

770 

1000 

790 

★ 

* 

CROSS-SECTION  2 

XK 

9.99 

1.3 

.3 

XI 

17.5  8 

370 

470 

9800 

11200 

10560 

ZO 

933 

HY 

1  SEC2 

GR 

995  50 

945 

70 

943 

370 

933 

380 

933 

460 

GR 

* 

943  470 

945 

720 

995 

740 

★ 

* 

CROSS-SECTION  3 

XK 

9.99 

1.45 

.3 

XI 

15.5  8 

420 

495 

8150 

8250 

7920 

ZO 

929 

GR 

991  200 

941 

220 

939 

420 

929 

430 

929 

485 

GR 

* 

939  495 

941 

695 

991 

715 

* 

* 

CROSS-SECTION  4 

XK 

12.99 

1.5 

.5 

XI 

14.0  8 

445 

505 

5280 

5280 

5280 

ZO 

926 

GR 

988  300 

951 

320 

939 

445 

926 

450 

926 

500 

GR 

* 

939  505 

951 

635 

988 

655 

★ 

CROSS-SECTION  5 

IC 

* 

1.0  1.0 

o 

CM 

.07 

XI 

13.0  8 

470 

530 

5280 

5280 

5280 

ZO 

924 

HY 

1  SECS 

GR 

986  325 

949 

345 

937 

470 

924 

475 

924 

525 

GR 

* 

937  530 

949 

630 

986 

650 

■k 

ic 

CROSS-SECTION  6 

XK 

12.99 

1.3 

.50 

XI 

12.0  8 

470 

540 

8250 

7920 

7920 

ZO 

922 

HY 

1  SEC6 

GR 

984  300 

947 

320 

935 

470 

922 

475 

922 

535 

GR 

* 

935  540 

947 

690 

984 

710 

* 

★ 

CROSS-SECTION  7 

XK 

11.99 

1.25 

.50 

XI 

10.5  8 

470 

560 

10560 

10560 

10560 

ZO 

919 

GR 

981  250 

941 

270 

931 

470 

919 

480 

919 

550 

GR 

* 

931  560 

941 

760 

981 

780 

* 

* 

CROSS-SECTION  8 

IC 

1.0  1.0 

2.0 

.07 

-1. 

XK 

9.99 

1.0 

.3 
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XI 

8.5 

8 

530 

630 

15840 

15840 

15840 

zo 

915 

GR 

977 

200 

927 

220 

925 

530 

915 

540 

915 

620 

GR 

★ 

925 

630 

927 

880 

977 

900 

★ 

★ 

CROSS- 

SECTION 

9 

XI 

5.5 

8 

420 

525 

29040 

29040 

29040 

ZO 

909 

HY 

1  SEC9 

GR 

971 

50 

921 

70 

919 

420 

909 

430 

909 

515 

GR 

* 

919 

525 

921 

825 

971 

845 

* 

★ 

CROSS- 

SECTION 

10 

XI 

0.0 

8 

420 

525 

ZO 

898 

HY 

1  SECIO 

GR 

960 

50 

910 

70 

908 

420 

898 

430 

898 

515 

GR 

908 

525 

910 

825 

960 

845 

* 


DB 

* 

EJ 


As  described  earlier,  CSECT  calculates  a  table  of  the  geometric  and  conveyance 
properties  at  each  cross  section.  At  those  cross  sections  where  an  ice  cover  is 
specified,  the  tables  are  modified  to  reflect  the  presence  of  the  specified  ice  cover.  The 
area  of  the  channel  is  reduced  to  account  for  the  submerged  portion  of  the  ice  cover. 
The  conveyance  is  modified  to  account  for  the  composite  roughness  of  the  channel 
and  the  increase  in  the  wetted  perimeter  of  the  channel.  The  composite  roughness  is 
found  by  combining  the  channel  Manning's  n  value  and  the  ice  cover  Manning's  n  value 
using  the  Balokon-Sabaneev  formula  (Ashton,  1986).  Generally  these  modifications  will 
have  the  effect  of  reducing  the  channel  conveyance.  The  reduction  in  conveyance  may 
be  dramatic  even  in  channels  where  the  submerged  area  of  the  ice  cover  is  quite  small. 
This  can  be  seen  in  Figures  D-12  and  D-13  in  which  the  open  water  and  ice-covered 
cross  section  areas  and  conveyances  are  shown  for  a  typical  cross  section  in  this 
example. 
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Figure  D-12  Open  water  and  ice-covered  areas. 


Figure  D-13  Open  water  and  ice-covered  conveyances. 
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An  example  of  the  table  produced  by  CSECT  is  shown  in  Table  D-9.  Note  that 
ice  information  is  displayed  immediately  before  the  table. 


Table  D-9 

CSECT  Table  Output. 

ICS#  S.  ICE  DATA  AT  R.M.  13.000 


ICE  THICKNESS:  LOB 

:  1.00  CH: 

2.00 

ROB: 

1.00  ICE 

n: 

0.07  SPEC.  GRAV. 

:  0.916 

ICS#  5. 

CROSS  SECTION  PROPERTIES 

AT  R.M 

13.000 

ELEV 

ALOB 

ACH 

AROB  AREA 

CLOB 

CCH 

CROB 

CONV 

BAREA 

TW 

SLOB  SROB 

S 

ALPHA 

BETA 

(ft) 

- 

(tt  2) 

(ft) 

< - -  (ft^2) 

— > 

< —  CO 

eff  --> 

it  it  ir  ir  it  it 

-Ur*******' 

************** 

************** 

*********. 

iritiririr 

ieiririritit 

**** 

***************** 

*  ir  it 

************* 

925.84 

0. 

1. 

0.  1. 

0. 

0. 

0. 

0. 

0. 

50. 

0.  0. 

0. 

1.00 

1.00 

927.34 

0. 

76. 

0.  76. 

0. 

2. 

0. 

2. 

0. 

51. 

0.  0. 

0. 

1.00 

1.00 

928.84 

0, 

154. 

0.  154. 

0, 

6. 

0. 

6. 

0. 

52. 

0.  0. 

0. 

1.00 

1.00 

930.34 

0. 

233. 

0.  233. 

0. 

11. 

0. 

11. 

0. 

53. 

0.  0. 

0. 

1.00 

1.00 

931.84 

0. 

314. 

0.  314, 

0. 

17. 

0. 

17. 

0. 

55. 

0,  0. 

0. 

1.00 

1.00 

933.34 

0. 

397. 

0.  397. 

0. 

25. 

0. 

25. 

0. 

56. 

0.  0. 

0. 

1.00 

1.00 

934.84 

0. 

482. 

0.  482. 

0. 

34. 

0. 

34. 

0. 

57. 

0.  0. 

0. 

1.00 

1,00 

936.34 

0. 

568. 

0.  568. 

0. 

43. 

0. 

43. 

0. 

58. 

0.  0. 

0. 

1.00 

1.00 

937.84 

0. 

656. 

0.  656. 

0. 

54. 

0. 

54. 

0. 

59. 

0.  0. 

0. 

1.00 

1.00 

939.34 

11. 

746. 

8.  765. 

0. 

66. 

0. 

66. 

0. 

87. 

0.  0. 

0. 

1.04 

1.02 

940.84 

45. 

836. 

36.  916. 

1. 

79. 

1. 

81. 

0. 

115. 

0.  0. 

0. 

1.14 

1.06 

942.34 

102. 

926. 

82.  1109. 

2. 

94. 

2. 

98. 

0. 

143. 

0.  0. 

0. 

1.26 

1.11 

943.84 

183. 

1016. 

146.  1345. 

5. 

110. 

4. 

119. 

0. 

171. 

0.  0. 

0. 

1.39 

1.15 

945.34 

287. 

1106. 

230.  1623. 

9. 

127. 

7. 

143. 

0. 

199. 

0.  0. 

0. 

1.51 

1.19 

946.84 

415. 

1196. 

332.  1943. 

15. 

144. 

12, 

171. 

0. 

227. 

0.  0. 

0. 

1.60 

1.22 

948.34 

566. 

1286. 

453.  2305. 

23. 

163. 

18. 

204. 

0. 

255. 

0.  0. 

0. 

1.68 

1.24 

949.84 

741. 

1376. 

593.  2709. 

33. 

182. 

26. 

241. 

0. 

284. 

0.  0. 

0. 

1.74 

1.25 

951.34 

929. 

1466. 

743.  3138. 

47. 

202. 

37. 

287. 

0. 

287. 

0.  0. 

0. 

1.70 

1,23 

952.84 

1118. 

1556. 

895.  3569. 

64. 

224. 

51. 

338. 

0. 

288. 

0.  0. 

0. 

1.65 

1.21 

954.34 

1309. 

1646. 

1048.  4002. 

82. 

246. 

65. 

393. 

0. 

290. 

0.  0. 

0. 

1.60 

1.19 

955.84 

1500. 

1736. 

1202.  4438. 

102. 

268. 

81. 

452, 

0. 

291. 

0.  0. 

0. 

1.55 

1.17 

2MN  = 

924.00 

XSZMN  =  924.00 

10APR95 

15:21 

:57 

PAGE 

ICS#  6, 

ICE  DATA 

AT  R.M.  12.000 

ICE 

THICKNESS:  LOB: 

1,00  CH: 

2.00 

ROB: 

1.00  ICE 

n: 

0.07  SPEC 

;.  GRAV.  ! 

:  0.916 

ICS#  6, 

CROSS  SECTION 

PROPERTIES 

AT  R.M. 

12.000 

ELEV 

ALOB 

ACH 

AROB 

AREA 

CLOB 

CCH 

CROB 

CONV 

BAREA 

TW 

SLOB 

SROB 

s 

ALPHA 

BETA 

(ft) 

^2_) _ 

_  r  . 

(ft-2) 

(ft) 

•  (rt  2)  - 

CO 

ett  — 

**** 

***** 

********* 

************** 

****** 

***************** 

***** 

****** 

**** 

******************** 

****** 

******* 

923.84 

0. 

1. 

0. 

1. 

0. 

0. 

0. 

0. 

0. 

60. 

0. 

0. 

0. 

1.00 

1.00 

925.14 

0. 

79. 

0. 

79. 

0. 

2. 

0. 

2. 

0. 

61. 

0. 

0. 

0. 

1.00 

1.00 

926.44 

0. 

159. 

0. 

159. 

0. 

5. 

0. 

5. 

0. 

62. 

0. 

0. 

0. 

1.00 

1.00 

927.74 

0. 

240. 

0. 

240. 

0. 

10. 

0. 

10. 

0. 

63. 

0. 

0. 

0. 

1.00 

1.00 

929.04 

0, 

323. 

0. 

323. 

0. 

17. 

0. 

17. 

0. 

64. 

0. 

0. 

0. 

1.00 

1.00 

930.34 

0. 

407. 

0. 

407. 

0. 

24. 

0. 

24. 

0. 

65, 

0. 

0. 

0, 

1.00 

1,00 

931.64 

0. 

492. 

0. 

492. 

0. 

32, 

0. 

32. 

0. 

66. 

0. 

0. 

0. 

1.00 

1.00 

932.94 

0. 

579. 

0. 

579. 

0. 

41. 

0. 

41. 

0. 

67. 

0. 

0. 

0. 

1.00 

1.00 

934.24 

0. 

666. 

0. 

666. 

0. 

51. 

0. 

51. 

0. 

68. 

0. 

0. 

0. 

1.00 

1.00 

935.54 

0. 

755. 

0. 

755. 

0. 

62. 

0. 

62. 

0. 

69. 

0. 

0, 

0. 

1.00 

1.00 

936.84 

5. 

846. 

5. 

856. 

0. 

74. 

0. 

74. 

0. 

93. 

0. 

0. 

0. 

1.02 

1.01 

938.14 

31. 

937. 

31. 

999. 

0. 

88. 

0. 

89. 

0. 

126. 

0, 

0. 

0. 

1.10 

1.05 

939.44 

78. 

1028. 

78. 

1183. 

2. 

102. 

2. 

105. 

0. 

158. 

0. 

0. 

0. 

1.22 

1.09 

940.74 

146. 

1119. 

146. 

1410. 

3. 

118. 

3. 

125. 

0. 

191. 

0. 

0. 

0. 

1.34 

1.14 

942.04 

235. 

1210. 

235. 

1679. 

7. 

134. 

7. 

148. 

0. 

223. 

0. 

0. 

0. 

1.46 

1.18 

943.34 

345. 

1301. 

345. 

1990. 

11. 

152. 

11. 

174. 

0. 

256. 

0. 

0. 

0. 

1.57 

1.21 

944.64 

476. 

1392. 

476. 

2343. 

17. 

170, 

17. 

204. 

0. 

288, 

0. 

0. 

0. 

1.67 

1.24 

945.94 

628. 

1483. 

628. 

2739. 

25. 

189. 

25. 

238. 

0. 

321. 

0. 

0. 

0. 

1.75 

1.26 

947.24 

802. 

1574. 

802. 

3177. 

34. 

208. 

34. 

276. 

0. 

353. 

0. 

0. 

0. 

1.80 

1.27 

948.54 

994. 

1665. 

994. 

3653  . 

47. 

229. 

47. 

322. 

0. 

371. 

0. 

0, 

0. 

1.80 

1,26 

949.84 

1190. 

1756. 

1190. 

4135. 

63. 

250. 

63. 

376. 

0. 

372. 

0. 

0. 

0. 

1.75 

1.24 
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UNET  Input  File 

There  are  no  changes  required  to  the  UNET  input  file  when  the  ice  option  is  selected. 
The  UNET  input  file  for  this  example  is  the  following: 

WORKSHOP  NO.  2 
SINGLE  REACH  STREAM 
ICE 
★ 

*  Job  control  information 

* 

JOB  CONTROL 

T  T  5MIN  48  6  F  0.6  T  T  -1  30MIN 

* 

*  Time  window  of  simulation 

* 

TIME  WINDOW 

18MAR1991  0000  20MAR1991  2400 
* 

*  Read  upstream  inflow  hydrograph  from  DSS 

* 

OPEN  DSS  FILE 

WK2  18MAR1991  0000  20MAR1991  2400  0.50 
UPSTREAM  FLOW  HYDROGRAPH 
1 

/ WORKSHP2 / SECl / FLOW/ 1 8MAR1 991/3  OMIN/ INFLOW/ 

* 

*  Specify  downstream  boundary  condition  with  Manning's. 

*  This  boundary  condition  was  placed  5.5  miles  downstream 

*  of  the  study  area. 

* 

DOWNSTREAM  MANNINGS 
1  0.00038 
* 

*  Set  initial  conditions  in  the  reach 

* 

INITIAL  FLOW  CONDITIONS 
1  500 
★ 

^  Close  previously  opened  DSS  file 
* 

CLOSE  DSS  FILE 
* 

*  Set  maximum  number  of  iterations  for  Newton  Raphson  iteration  scheme 

* 

MXITER  =10 
* 

*  Set  stage  tolerace  to  0.01  ft,  for  convergence  criteria 

* 

ZTOL=0.01 

Hr 

*  Open  DSS  file  for  writing  results 

* 

WRITE  HYDROGRAPHS  TO  DSS 
ICE. DSS 
EJ 


Results 

All  data  requested  by  the  user  to  be  written  to  the  DSS  data  file  will  be  written 
without  modification.  In  addition,  if  the  user  has  selected  the  Job  Control  Option  in  the 
UNET  input  file  to  write  instantaneous  flow  and  water  surface  profiles  to  DSS.  (Variable 
PT  on  the  JOB  CONTROL  record),  the  instantaneous  top  and  bottom  ice  surface 
elevations  are  also  written  to  DSS  (see  Appendix  B  for  details).  In  the  following  figures, 
two  of  the  instantaneous  profiles  are  displayed;  one  with  ice,  and  a  second  profile  in 
which  the  ice  cover  was  removed.  The  open  water  results  are  shown  by  the  data 
marked  by  the  circles.  A  brief  discussion  of  the  results,  based  on  the  figures  follows. 
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In  Figure  D-14,  the  discharge  hydrographs  calculated  at  the  downstream  end  of 
the  river  (SEC10)  are  shown.  It  can  be  seen  that  the  open  water  hydrograph  (dashed 
line)  peak  occurs  before  the  ice-cover  peak  (solid  line),  and  that  the  ice-cover  peak  is 
smaller  than  the  open  water  peak.  Both  of  these  results  can  be  attributed  to  the 
reduction  in  conveyance  caused  by  the  presence  of  the  ice  cover.  This  is  true  even 
though  the  ice  cover  covers  only  4.5  miles  of  the  20  mile  channel. 


Figure  D-14  Open  water  and  ice-covered  flows  at  the  downstream  end  of  the  river 
(SEC10). 


In  Figure  D-15,  the  open  water  and  ice-cover  water  surface  profiles  are  shown  at 
the  start  of  the  simulation.  At  this  time  the  flow  is  approximately  500  ft^s  along  the 
entire  length  of  the  channel.  The  reduction  in  conveyance  caused  by  the  ice  cover  is 
clearly  evident  in  the  raised  water  surface  profile  relative  to  the  open  water  profile  which 
extends  over  the  length  of  the  cover  and  for  some  distance  upstream.  It  is  this 
reduction  in  conveyance  which  reduces  the  peak  of  the  hydrograph  and  delays  its 
passage. 
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Figure  D-15  Open  water  and  ice  covered  water  surface 

profiles.  (Open  water  data  marked  with  circles.) 
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In  Figure  D-16,  the  open  water  and  ice-cover  profiles  are  shown  at  a  later  time. 
At  this  time,  because  the  open  water  hydrograph  leads  the  ice-cover  hydrograph,  it  can 
be  seen  that  the  open  water  stages  in  the  downstream  half  of  the  river  are  greater  then 
those  of  the  of  the  ice  covered  stages. 


OPEN  WATER  &  TOP  AMO  BOTTOM  tCE  PROFILES  ISMARIflSI  AT  1800 


L  OC.  IN  MILES 


Figure  D-16  Open  water  and  ice  covered  water  surface  profiles. 


In  Figure  D-17,  the  reverse  of  Figure  D-16  has  occurred.  The  open  water 
hydrograph  has  largely  passed  through  the  river,  and  because  the  ice-cover  hydrograph 
has  been  delayed,  the  stages  in  the  downstream  half  of  the  river  with  an  ice  cover  are 
greater. 
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In  Figure  D-18,  the  open  water  and  ice-cover  stage  hydrographs  are  shown  at 
the  upstream  end  of  the  ice  cover  (SECS).  It  can  be  seen  that  at  this  location  the  ice- 
covered  stages  always  exceed  the  open  water  stages. 
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00  0  0  0  0  0  0  1  2  0  0  laoo  OOOO  0  0  0  0  1  2  0  0  1  0  0  0  0  0  0  0  0  0  0  0  1  2  0  0  1  0  0  0  0  0  0  0 

^  lOMARtl  ^  ItMAROI  ^  20MARt1  ^ 


1  8ECI  ICE  •TAOE 

1  SECS  OPEN  stage 


Figure  D-18  Open  water  and  ice-covered  stage  hydrographs  at  the  upstream 
end  of  the  ice  cover  (SECS). 
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HEC-2  Backwater  Data  Sets 
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EASY  PROCEDURE  TO  BUILD  HEC-2  DOWNWATER  DATA  SETS 

from 

BACKWATER  DATA  SETS 


The  following  procedure  utilizes  the  HEC-2  "TAPE16"  option  and  the  COED 
"macro"  command  feature  to  minimize  the  effort  to  change  an  HEC-2  backwater  data 
set  to  a  downwater  data  set. 


(1)  Do  NOT  attempt  to  invert  a  data  set  which  employs  repeated  GR  data.  The 
HEC-2  TAPE1 6  option  should  be  used  to  create  a  filled  in  data  data  set  ( a  data  set 
without  repeated  GR  data).  To  use  the  TAPE1 6  option,  enter  “'I  “  ''® '1°' 

the  first  J2  record  (J2.8  =  -1).  When  the  data  set  is  executed  with  HEC-2,  a  TAPtib 
file  will  be  generated.  The  TAPE16  file  consists  of  NC-GR  records  only;  title,  job  and 
end  records  (T1-J2,  EJ,  and  ER)  must  be  added  to  this  file. 


(2)  While  in  the  COED  "line-edit  mode"^  with  the  HEC-2  or  TAPE16  data  file, 
create  the  macro^  (string  of  line  edit  commands)  shown  below  and  execute  with  t  e 
following  commands: 


E>T 

E>Z  1-2 

E>X^ ,  B,  -L^/Xl/  ,  -L^ GR/OR/Tl/  ,  N,  ST,  F^E J, U,  EN,  PUT^MXFILE . DAT, RE, 
E>X  * 


E>QUIT 

(NOTE:  spaces  are  significant,  ^  indicates  a  space.) 


This  use  of  the  COED  macro  command  will  build  an  HEC-2  data  set,  named 
MYFILE.DAT,  in  the  proper  (reverse)  order  for  downwater  (supercritical)  ana  ysis.  e 
reach  lengths  for  each  cross  section  do  NOT  need  to  be  modified  becau^se  ' 
represent  the  distance  from  the  current  section  to  its  downstream 
applied  with  an  unmodified  TAPE16  file,  this  macro  wHI 

section  to  the  new  data  set;  T1  and  EJ  records  must  be  added  to  the  TAPE16  fil 
before  execution  of  the  above  commands  in  order  to  transfer  all  the  sections. 


1 


2 


E>  is  the  COED  line-edit  prompt,  you  do  not  type  this.  Press  F10  to  enter  line-edit  mode  from  full 
screen  mode  in  COED. 


TP  COED  macro  is  the  string  of  characters  entered  with  the  X  command.  X  and  Y  are  the  macro 
Jmmands  avSleroOED.  The  command  X  *  will  perfom.  the  X  macro  for  all  followrng  lines, 
ge  your  COED  user’s  manual  for  complete  details. 

- - - — - - - -  '  ^  E^ 
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When  using  this  procedure  or  any  other  to  convert  an  HEC-2  data  set  the  new 
data  set  should  be  thoroughly  checked  for  completeness  and  proper  order  (order  of 
"NC"  and  "QT"  records  must  be  carefully  checked).  Remember  also  to  indicate 
supercritical  flow  regime  by  setting  IDIR  equal  to  1  (J1 .4  =  1). 
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